colored


Namecolored JSON
Version 2.2.3 PyPI version JSON
download
home_pageNone
SummarySimple python library for color and formatting to terminal
upload_time2023-07-12 17:47:56
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseNone
keywords xterm color colour vt100 ansi terminal text rgb linux windows
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <a href="https://dslackw.gitlab.io/colored"> 
<img src="https://gitlab.com/dslackw/colored/-/raw/site/docs/images/colored.png" title="colored"></a>

## About

Colored, it's a simple Python library for color and formatting in terminal.
Collection of color codes and names for 256 color terminal setups. 
Colored now supports RGB color mode. As "true color" graphic cards with 16 to <a href="https://en.wikipedia.org/wiki/ANSI_escape_code#24-bit" target="_blank">24 bits</a> of color became common, 
applications began to support 24-bit colors. Terminal emulators supporting setting 24-bit foreground and background 
colors with escape sequences include Xterm, KDE's <a href="https://en.wikipedia.org/wiki/Konsole" target="_blank">Konsole</a>, and iTerm, as well as all libvte based terminals,
including <a href="https://en.wikipedia.org/wiki/GNOME_Terminal" target="_blank">GNOME Terminal</a>.

The colors work with most terminals and terminals emulators.
<a href="https://en.wikipedia.org/wiki/ANSI_escape_code" target="_blank">ANSI/VT100 escape sequences</a> can be used in every programming languages.

Colored is powerful and easy to use:

```python title="Python 3.9.17"
>>> from colored import Fore, Back, Style
>>>
>>> Fore.red
'\x1b[38;5;1m'
>>>
>>> Back.red
'\x1b[48;5;1m'
>>>
>>> Style.reset
'\x1b[0m'
>>> 
>>> Fore.rgb('100%', '50%', '30%')
'\x1b[38;2;255;130;79m'
>>>
>>> print(f'{Fore.white}{Back.green}Colored is Awesome!!!{Style.reset}')
```
!!! success
    <p> >>> <span style="background-color: green">
      <span style="color: white">Colored is Awesome!!!</span></span>
    </p>

## Installing

Open up a terminal and install colored with <a href="https://pip.pypa.io/en/stable/" target="_blank">pip</a> command:

```bash
$ pip install colored
```

Alternatively, you can grab the latest source code from <a href="https://gitlab.com/dslackw/colored" target="_blank">GitLab</a>:
```bash
$ git clone https://gitlab.com/dslackw/colored.git
$ cd colored
$ pip install .
```

## Usage

The [User Guide](https://dslackw.gitlab.io/colored/user_guide/user_guide/#user-guide) is the place to go to learn how to use the library. 

The [API Reference](https://dslackw.gitlab.io/colored/api/attributes/) documentation provides API-level documentation.

## License

colored is made available under the MIT License. For more details, see [here](https://dslackw.gitlab.io/colored/license/#mit-license).

## Contributing

!!! info
    We happily welcome [contributions](https://dslackw.gitlab.io/colored/contributors/)!

## Donate

Did you know that we developers love coffee? 

[<img src="https://gitlab.com/dslackw/colored/-/raw/site/docs/images/paypaldonate.png" alt="paypal" title="donate">](https://www.paypal.me/dslackw)
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "colored",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": null,
    "keywords": "xterm,color,colour,vt100,ansi,terminal,text,rgb,linux,windows",
    "author": null,
    "author_email": "Dimitris Zlatanidis <dslackw@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/d2/ce/cca52eb08fdb44fd99e0dd16de52228cb4ef108d7aff7c3bc359bc9b103c/colored-2.2.3.tar.gz",
    "platform": null,
    "description": "<a href=\"https://dslackw.gitlab.io/colored\"> \n<img src=\"https://gitlab.com/dslackw/colored/-/raw/site/docs/images/colored.png\" title=\"colored\"></a>\n\n## About\n\nColored, it's a simple Python library for color and formatting in terminal.\nCollection of color codes and names for 256 color terminal setups. \nColored now supports RGB color mode. As \"true color\" graphic cards with 16 to <a href=\"https://en.wikipedia.org/wiki/ANSI_escape_code#24-bit\" target=\"_blank\">24 bits</a> of color became common, \napplications began to support 24-bit colors. Terminal emulators supporting setting 24-bit foreground and background \ncolors with escape sequences include Xterm, KDE's <a href=\"https://en.wikipedia.org/wiki/Konsole\" target=\"_blank\">Konsole</a>, and iTerm, as well as all libvte based terminals,\nincluding <a href=\"https://en.wikipedia.org/wiki/GNOME_Terminal\" target=\"_blank\">GNOME Terminal</a>.\n\nThe colors work with most terminals and terminals emulators.\n<a href=\"https://en.wikipedia.org/wiki/ANSI_escape_code\" target=\"_blank\">ANSI/VT100 escape sequences</a> can be used in every programming languages.\n\nColored is powerful and easy to use:\n\n```python title=\"Python 3.9.17\"\n>>> from colored import Fore, Back, Style\n>>>\n>>> Fore.red\n'\\x1b[38;5;1m'\n>>>\n>>> Back.red\n'\\x1b[48;5;1m'\n>>>\n>>> Style.reset\n'\\x1b[0m'\n>>> \n>>> Fore.rgb('100%', '50%', '30%')\n'\\x1b[38;2;255;130;79m'\n>>>\n>>> print(f'{Fore.white}{Back.green}Colored is Awesome!!!{Style.reset}')\n```\n!!! success\n    <p> >>> <span style=\"background-color: green\">\n      <span style=\"color: white\">Colored is Awesome!!!</span></span>\n    </p>\n\n## Installing\n\nOpen up a terminal and install colored with <a href=\"https://pip.pypa.io/en/stable/\" target=\"_blank\">pip</a> command:\n\n```bash\n$ pip install colored\n```\n\nAlternatively, you can grab the latest source code from <a href=\"https://gitlab.com/dslackw/colored\" target=\"_blank\">GitLab</a>:\n```bash\n$ git clone https://gitlab.com/dslackw/colored.git\n$ cd colored\n$ pip install .\n```\n\n## Usage\n\nThe [User Guide](https://dslackw.gitlab.io/colored/user_guide/user_guide/#user-guide) is the place to go to learn how to use the library. \n\nThe [API Reference](https://dslackw.gitlab.io/colored/api/attributes/) documentation provides API-level documentation.\n\n## License\n\ncolored is made available under the MIT License. For more details, see [here](https://dslackw.gitlab.io/colored/license/#mit-license).\n\n## Contributing\n\n!!! info\n    We happily welcome [contributions](https://dslackw.gitlab.io/colored/contributors/)!\n\n## Donate\n\nDid you know that we developers love coffee? \n\n[<img src=\"https://gitlab.com/dslackw/colored/-/raw/site/docs/images/paypaldonate.png\" alt=\"paypal\" title=\"donate\">](https://www.paypal.me/dslackw)",
    "bugtrack_url": null,
    "license": null,
    "summary": "Simple python library for color and formatting to terminal",
    "version": "2.2.3",
    "project_urls": {
        "homepage": "https://dslackw.gitlab.io/colored/"
    },
    "split_keywords": [
        "xterm",
        "color",
        "colour",
        "vt100",
        "ansi",
        "terminal",
        "text",
        "rgb",
        "linux",
        "windows"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "6f0da10351ef1a98e0b03d66887ec2d87c261f9a0fbff8f2bdb75614cc0a2850",
                "md5": "83c81c246e2a53432844d391d10e61c3",
                "sha256": "1318b2fb8e0313d39724b8ab0707af79d1e2c0e60710b608a00e70fe0f84ff5d"
            },
            "downloads": -1,
            "filename": "colored-2.2.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "83c81c246e2a53432844d391d10e61c3",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 16108,
            "upload_time": "2023-07-12T17:47:49",
            "upload_time_iso_8601": "2023-07-12T17:47:49.682216Z",
            "url": "https://files.pythonhosted.org/packages/6f/0d/a10351ef1a98e0b03d66887ec2d87c261f9a0fbff8f2bdb75614cc0a2850/colored-2.2.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d2cecca52eb08fdb44fd99e0dd16de52228cb4ef108d7aff7c3bc359bc9b103c",
                "md5": "65a409a12512f76f6ef41055c777b210",
                "sha256": "1905ae45fa2b7fd63a8b4776586e63aeaba4df8db225b72b78fd167408558983"
            },
            "downloads": -1,
            "filename": "colored-2.2.3.tar.gz",
            "has_sig": false,
            "md5_digest": "65a409a12512f76f6ef41055c777b210",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 13209,
            "upload_time": "2023-07-12T17:47:56",
            "upload_time_iso_8601": "2023-07-12T17:47:56.536675Z",
            "url": "https://files.pythonhosted.org/packages/d2/ce/cca52eb08fdb44fd99e0dd16de52228cb4ef108d7aff7c3bc359bc9b103c/colored-2.2.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-07-12 17:47:56",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "colored"
}
        
Elapsed time: 0.55670s