<h1>hexor</h1>
<p>Coloring texts and their backgrounds in command line interface (cli), with rgb or hex types.</p>
[![Test on Ubuntu latest](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-linux.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-linux.yml)
[![Test on Windows latest](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-win.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-win.yml)
[![Test on MacOS latest](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-mac.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-mac.yml)
[![pypi-setup](https://github.com/yasserbdj96/hexor/actions/workflows/pypi-setup.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/pypi-setup.yml)
[![Upload to PYPI](https://github.com/yasserbdj96/hexor/actions/workflows/pipup.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/pipup.yml)
[![Deploy static content to Pages](https://github.com/yasserbdj96/hexor/actions/workflows/pages.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/pages.yml)
[![CodeQL](https://github.com/yasserbdj96/hexor/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/codeql-analysis.yml)
[![CodeFactor](https://www.codefactor.io/repository/github/yasserbdj96/hexor/badge)](https://www.codefactor.io/repository/github/yasserbdj96/hexor)
[![Supported Versions](https://img.shields.io/pypi/pyversions/hexor.svg)](https://pypi.org/project/hexor)
[![Visitors](https://visitor-badge.laobi.icu/badge?page_id=yasserbdj96.hexor&format=true)](https://github.com/yasserbdj96/hexor)
[![Open Source](https://img.shields.io/badge/Open%20Source-%E2%99%A5-red)](https://github.com/yasserbdj96/hexor)
[![Stars](https://img.shields.io/github/stars/yasserbdj96/hexor?color=red)](https://github.com/yasserbdj96/hexor)
[![Forks](https://img.shields.io/github/forks/yasserbdj96/hexor?color=red)](https://github.com/yasserbdj96/hexor)
[![Watching](https://img.shields.io/github/watchers/yasserbdj96/hexor?label=Watchers&color=red&style=flat-square)](https://github.com/yasserbdj96/hexor)
![GitHub contributors](https://img.shields.io/github/contributors/yasserbdj96/hexor)
![GitHub closed issues](https://img.shields.io/github/issues-closed/yasserbdj96/hexor)
![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/yasserbdj96/hexor)
![GitHub release (latest by date)](https://img.shields.io/github/v/release/yasserbdj96/hexor)
![GitHub commit activity](https://img.shields.io/github/commit-activity/m/yasserbdj96/hexor)
![GitHub last commit](https://img.shields.io/github/last-commit/yasserbdj96/hexor)
[![GitHub license](https://img.shields.io/github/license/yasserbdj96/hexor)](https://github.com/yasserbdj96/hexor)
[![Join the chat at https://gitter.im/yasserbdj96/hexor](https://badges.gitter.im/yasserbdj96/hexor.svg)](https://gitter.im/yasserbdj96/hexor?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
<h2>Languages:</h2>
* python3
<h2>Supported Distributions:</h2>
| Distribution | Version Check | Python Version | Supported | Status | Everything works |
| :------------: | :-----------: | :------------: | :-------: | :-------: | :--------------: |
| Ubuntu | Last version | 3.7 --> 3.11 | ✓ | ✓ | ✓ |
| Windwos | Last version | 3.7 --> 3.11 | ✓ | ✓ | ✓ |
| MacOS | Last version | 3.7 --> 3.11 | ✓ | ✓ | ✓ |
| Android-termux | Last version | 3.7 --> 3.11 | ✓ | ✓ | ✓ |
| Nethunter | Last version | 3.7 --> 3.11 | ✓ | ✓ | ✓ |
<h2>Python Package Installation:</h2>
```
# install from pypi:
❯ pip install hexor
# local install:
❯ git clone https://github.com/yasserbdj96/hexor.git
❯ cd hexor
❯ pip install .
```
<h2>Script Usage:</h2>
```python
from hexor import hexor
# Usage example:
# p1 = hexor(return_option)
## return_option: [True, False]
### True to return results
### False to print results
## color_format: ['hex', 'rgb']
### 'hex' for hex colors (e.g., #ffffff, #cccccc)
### 'rgb' for rgb colors (e.g., (255, 255, 255), rgb(250, 12, 0))
# The default options are: hexor() = hexor(False)
p1 = hexor(<return_option>)
# To change text color only:
p1.c("<TEXT>", "<FOREGROUND>")
# To change text color and background together:
p1.c("<TEXT>", "<FOREGROUND>", "<BACKGROUND>")
```
<h2>Script Examples:</h2>
```python
from hexor import *
# Example:1
p1=hexor()
p1.c("Text is red","#ff0000")
p1.c("Text is red and background is blue","#ff0000","#1a73e8")
# Example:2
p2=hexor(True)
print(p2.c("Text is red","#ff0000"))
print(p2.c("Text is red and background is blue","#ff0000","#1a73e8"))
# Example:3
p3=hexor()
p3.c("Text is red","255,0,0")
p3.c("Text is red and background is blue","255,0,0","26,115,232")
# Example:4
p4=hexor(True)
print(p4.c("Text is red","255,0,0"))
print(p4.c("Text is red and background is blue","255,0,0","26,115,232"))
# Example:5
p5=hexor()
p5.c("Text is red","rgb(255,0,0)")
p5.c("Text is red and background is blue","rgb(255,0,0)","rgb(26,115,232)")
# Example:6
p6=hexor(True)
print(p6.c("Text is red","rgb(255,0,0)"))
print(p6.c("Text is red and background is blue","rgb(255,0,0)","rgb(26,115,232)"))
# Example:7
p7=hexor()
p7.c("Text is red and background is blue","rgb(255,0,0)","26,115,232")
p7.c("Text is red and background is blue","255,0,0","rgb(26,115,232)")
p7.c("Text is red and background is blue","rgb(255,0,0)","#1a73e8")
p7.c("Text is red and background is blue","255,0,0","#1a73e8")
# Example:8
hexor().c("Text is red","#ff0000")
hexor().c("Text is red and background is blue","255,0,0","rgb(26,115,232)")
# Example:9
print(hexor(True).c("Text is red","#ff0000"))
print(hexor(True).c("Text is red and background is blue","255,0,0","rgb(26,115,232)"))
```
<h2>Screenshot:</h2>
<div align="center">
<a href="https://raw.githubusercontent.com/yasserbdj96/hexor/main/screenshot/screenshot.png">
<img alt="yasserbdj96" height="100" src="https://raw.githubusercontent.com/yasserbdj96/hexor/main/screenshot/screenshot.png">
</a>
<a href="https://raw.githubusercontent.com/yasserbdj96/hexor/main/screenshot/screenshot_1.png">
<img alt="yasserbdj96" height="100" src="https://raw.githubusercontent.com/yasserbdj96/hexor/main/screenshot/screenshot_1.png">
</a>
</div>
<br>
<h2>Changelog History:</h2>
<a href="https://raw.githubusercontent.com/yasserbdj96/hexor/main/CHANGELOG">Click to See changelog History</a>
<br>
<h2>Development By:</h2>
Developer / Author: [yasserbdj96](https://github.com/yasserbdj96)
<br>
<h2>License:</h2>
<p>The content of this repository is bound by the following <a href="https://raw.githubusercontent.com/yasserbdj96/hexor/main/LICENSE">LICENSE</a>.</p>
<br>
<h2>Support:</h2>
<p>If you enjoy this project and would like to see it continue to improve, or if you would like me to create more interesting projects, please consider <a href="https://github.com/sponsors/yasserbdj96">sponsoring me</a>.</p>
<br>
<br>
<br><br>
<p align="center">
<samp>
<a href="https://yasserbdj96.github.io/">website</a> .
<a href="https://github.com/yasserbdj96">github</a> .
<a href="https://gitlab.com/yasserbdj96">gitlab</a> .
<a href="https://www.linkedin.com/in/yasserbdj96">linkedin</a> .
<a href="https://twitter.com/yasserbdj96">twitter</a> .
<a href="https://instagram.com/yasserbdj96">instagram</a> .
<a href="https://www.facebook.com/yasserbdj96">facebook</a> .
<a href="https://www.youtube.com/@yasserbdj96">youtube</a> .
<a href="https://pypi.org/user/yasserbdj96">pypi</a> .
<a href="https://hub.docker.com/u/yasserbdj96">docker</a> .
<a href="https://t.me/yasserbdj96">telegram</a> .
<a href="https://gitter.im/yasserbdj96/yasserbdj96">gitter</a> .
<a href="mailto:yasser.bdj96@gmail.com">e-mail</a> .
<a href="https://github.com/sponsors/yasserbdj96">sponsor</a>
</samp>
</p>
Raw data
{
"_id": null,
"home_page": "https://github.com/yasserbdj96/hexor",
"name": "hexor",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "yasserbdj96,python,hexor,texts,colors.,hex,background,rgb",
"author": "yasserbdj96",
"author_email": "yasser.bdj96@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/c1/c3/795e1ce53497e3bf41540fea2b5e6b7aa07aad6887ea0f5d19702d101b6a/hexor-0.0.15.tar.gz",
"platform": null,
"description": "<h1>hexor</h1>\n\n<p>Coloring texts and their backgrounds in command line interface (cli), with rgb or hex types.</p>\n\n[![Test on Ubuntu latest](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-linux.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-linux.yml)\n[![Test on Windows latest](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-win.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-win.yml)\n[![Test on MacOS latest](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-mac.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/python-app-on-mac.yml)\n[![pypi-setup](https://github.com/yasserbdj96/hexor/actions/workflows/pypi-setup.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/pypi-setup.yml)\n[![Upload to PYPI](https://github.com/yasserbdj96/hexor/actions/workflows/pipup.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/pipup.yml)\n[![Deploy static content to Pages](https://github.com/yasserbdj96/hexor/actions/workflows/pages.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/pages.yml)\n[![CodeQL](https://github.com/yasserbdj96/hexor/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/yasserbdj96/hexor/actions/workflows/codeql-analysis.yml)\n[![CodeFactor](https://www.codefactor.io/repository/github/yasserbdj96/hexor/badge)](https://www.codefactor.io/repository/github/yasserbdj96/hexor)\n[![Supported Versions](https://img.shields.io/pypi/pyversions/hexor.svg)](https://pypi.org/project/hexor) \n[![Visitors](https://visitor-badge.laobi.icu/badge?page_id=yasserbdj96.hexor&format=true)](https://github.com/yasserbdj96/hexor)\n[![Open Source](https://img.shields.io/badge/Open%20Source-%E2%99%A5-red)](https://github.com/yasserbdj96/hexor)\n[![Stars](https://img.shields.io/github/stars/yasserbdj96/hexor?color=red)](https://github.com/yasserbdj96/hexor)\n[![Forks](https://img.shields.io/github/forks/yasserbdj96/hexor?color=red)](https://github.com/yasserbdj96/hexor)\n[![Watching](https://img.shields.io/github/watchers/yasserbdj96/hexor?label=Watchers&color=red&style=flat-square)](https://github.com/yasserbdj96/hexor)\n![GitHub contributors](https://img.shields.io/github/contributors/yasserbdj96/hexor)\n![GitHub closed issues](https://img.shields.io/github/issues-closed/yasserbdj96/hexor)\n![GitHub pull requests](https://img.shields.io/github/issues-pr-raw/yasserbdj96/hexor)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/yasserbdj96/hexor)\n![GitHub commit activity](https://img.shields.io/github/commit-activity/m/yasserbdj96/hexor)\n![GitHub last commit](https://img.shields.io/github/last-commit/yasserbdj96/hexor)\n[![GitHub license](https://img.shields.io/github/license/yasserbdj96/hexor)](https://github.com/yasserbdj96/hexor)\n[![Join the chat at https://gitter.im/yasserbdj96/hexor](https://badges.gitter.im/yasserbdj96/hexor.svg)](https://gitter.im/yasserbdj96/hexor?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)\n\n<h2>Languages:</h2>\n* python3\n\n<h2>Supported Distributions:</h2>\n\n| Distribution | Version Check | Python Version | Supported | Status | Everything works |\n| :------------: | :-----------: | :------------: | :-------: | :-------: | :--------------: |\n| Ubuntu | Last version | 3.7 --> 3.11 | \u2713 | \u2713 | \u2713 |\n| Windwos | Last version | 3.7 --> 3.11 | \u2713 | \u2713 | \u2713 |\n| MacOS | Last version | 3.7 --> 3.11 | \u2713 | \u2713 | \u2713 |\n| Android-termux | Last version | 3.7 --> 3.11 | \u2713 | \u2713 | \u2713 |\n| Nethunter | Last version | 3.7 --> 3.11 | \u2713 | \u2713 | \u2713 |\n\n\n\n<h2>Python Package Installation:</h2>\n\n```\n# install from pypi:\n\u276f pip install hexor\n\n# local install:\n\u276f git clone https://github.com/yasserbdj96/hexor.git\n\u276f cd hexor\n\u276f pip install .\n```\n\n<h2>Script Usage:</h2>\n\n```python\nfrom hexor import hexor\n\n# Usage example:\n# p1 = hexor(return_option)\n\n## return_option: [True, False]\n### True to return results\n### False to print results\n\n## color_format: ['hex', 'rgb']\n### 'hex' for hex colors (e.g., #ffffff, #cccccc)\n### 'rgb' for rgb colors (e.g., (255, 255, 255), rgb(250, 12, 0))\n\n# The default options are: hexor() = hexor(False)\np1 = hexor(<return_option>)\n\n# To change text color only:\np1.c(\"<TEXT>\", \"<FOREGROUND>\")\n\n# To change text color and background together:\np1.c(\"<TEXT>\", \"<FOREGROUND>\", \"<BACKGROUND>\")\n```\n\n<h2>Script Examples:</h2>\n\n```python\nfrom hexor import *\n\n# Example:1\np1=hexor()\np1.c(\"Text is red\",\"#ff0000\")\np1.c(\"Text is red and background is blue\",\"#ff0000\",\"#1a73e8\")\n\n# Example:2\np2=hexor(True)\nprint(p2.c(\"Text is red\",\"#ff0000\"))\nprint(p2.c(\"Text is red and background is blue\",\"#ff0000\",\"#1a73e8\"))\n\n# Example:3\np3=hexor()\np3.c(\"Text is red\",\"255,0,0\")\np3.c(\"Text is red and background is blue\",\"255,0,0\",\"26,115,232\")\n\n# Example:4\np4=hexor(True)\nprint(p4.c(\"Text is red\",\"255,0,0\"))\nprint(p4.c(\"Text is red and background is blue\",\"255,0,0\",\"26,115,232\"))\n\n# Example:5\np5=hexor()\np5.c(\"Text is red\",\"rgb(255,0,0)\")\np5.c(\"Text is red and background is blue\",\"rgb(255,0,0)\",\"rgb(26,115,232)\")\n\n# Example:6\np6=hexor(True)\nprint(p6.c(\"Text is red\",\"rgb(255,0,0)\"))\nprint(p6.c(\"Text is red and background is blue\",\"rgb(255,0,0)\",\"rgb(26,115,232)\"))\n\n# Example:7\np7=hexor()\np7.c(\"Text is red and background is blue\",\"rgb(255,0,0)\",\"26,115,232\")\np7.c(\"Text is red and background is blue\",\"255,0,0\",\"rgb(26,115,232)\")\np7.c(\"Text is red and background is blue\",\"rgb(255,0,0)\",\"#1a73e8\")\np7.c(\"Text is red and background is blue\",\"255,0,0\",\"#1a73e8\")\n\n# Example:8\nhexor().c(\"Text is red\",\"#ff0000\")\nhexor().c(\"Text is red and background is blue\",\"255,0,0\",\"rgb(26,115,232)\")\n\n# Example:9\nprint(hexor(True).c(\"Text is red\",\"#ff0000\"))\nprint(hexor(True).c(\"Text is red and background is blue\",\"255,0,0\",\"rgb(26,115,232)\"))\n```\n\n<h2>Screenshot:</h2>\n\n<div align=\"center\">\n <a href=\"https://raw.githubusercontent.com/yasserbdj96/hexor/main/screenshot/screenshot.png\">\n <img alt=\"yasserbdj96\" height=\"100\" src=\"https://raw.githubusercontent.com/yasserbdj96/hexor/main/screenshot/screenshot.png\">\n </a>\n <a href=\"https://raw.githubusercontent.com/yasserbdj96/hexor/main/screenshot/screenshot_1.png\">\n <img alt=\"yasserbdj96\" height=\"100\" src=\"https://raw.githubusercontent.com/yasserbdj96/hexor/main/screenshot/screenshot_1.png\">\n </a>\n</div>\n\n<br>\n<h2>Changelog History:</h2>\n<a href=\"https://raw.githubusercontent.com/yasserbdj96/hexor/main/CHANGELOG\">Click to See changelog History</a>\n\n<br>\n<h2>Development By:</h2>\n\nDeveloper / Author: [yasserbdj96](https://github.com/yasserbdj96)\n\n<br>\n<h2>License:</h2>\n<p>The content of this repository is bound by the following <a href=\"https://raw.githubusercontent.com/yasserbdj96/hexor/main/LICENSE\">LICENSE</a>.</p>\n\n<br>\n<h2>Support:</h2>\n<p>If you enjoy this project and would like to see it continue to improve, or if you would like me to create more interesting projects, please consider <a href=\"https://github.com/sponsors/yasserbdj96\">sponsoring me</a>.</p>\n<br>\n<br>\n\n<br><br>\n\n<p align=\"center\">\n <samp>\n <a href=\"https://yasserbdj96.github.io/\">website</a> .\n <a href=\"https://github.com/yasserbdj96\">github</a> .\n <a href=\"https://gitlab.com/yasserbdj96\">gitlab</a> .\n <a href=\"https://www.linkedin.com/in/yasserbdj96\">linkedin</a> .\n <a href=\"https://twitter.com/yasserbdj96\">twitter</a> .\n <a href=\"https://instagram.com/yasserbdj96\">instagram</a> .\n <a href=\"https://www.facebook.com/yasserbdj96\">facebook</a> .\n <a href=\"https://www.youtube.com/@yasserbdj96\">youtube</a> .\n <a href=\"https://pypi.org/user/yasserbdj96\">pypi</a> .\n <a href=\"https://hub.docker.com/u/yasserbdj96\">docker</a> .\n <a href=\"https://t.me/yasserbdj96\">telegram</a> .\n <a href=\"https://gitter.im/yasserbdj96/yasserbdj96\">gitter</a> .\n <a href=\"mailto:yasser.bdj96@gmail.com\">e-mail</a> .\n <a href=\"https://github.com/sponsors/yasserbdj96\">sponsor</a>\n </samp>\n</p>\n\n",
"bugtrack_url": null,
"license": "Apache Software License",
"summary": "Coloring texts and their backgrounds in command line interface (cli), with rgb or hex types.",
"version": "0.0.15",
"project_urls": {
"Author WebSite": "https://yasserbdj96.github.io/",
"Chat": "https://gitter.im/yasserbdj96/hexor",
"Homepage": "https://github.com/yasserbdj96/hexor",
"Source": "https://github.com/yasserbdj96/hexor",
"Sponsor": "https://github.com/sponsors/yasserbdj96",
"WebSite": "https://yasserbdj96.github.io/hexor"
},
"split_keywords": [
"yasserbdj96",
"python",
"hexor",
"texts",
"colors.",
"hex",
"background",
"rgb"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5e50604c89858a3559f70db4dcc331516405b38db950ad2a9621c7ccb19e055a",
"md5": "070d1185221ea33b0b32387d67dbda4e",
"sha256": "aa24f03b2c318a890122080d78bb0343dcf879302a4163503e8339bf42d268c9"
},
"downloads": -1,
"filename": "hexor-0.0.15-py3-none-any.whl",
"has_sig": false,
"md5_digest": "070d1185221ea33b0b32387d67dbda4e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5633,
"upload_time": "2023-06-06T18:26:14",
"upload_time_iso_8601": "2023-06-06T18:26:14.315781Z",
"url": "https://files.pythonhosted.org/packages/5e/50/604c89858a3559f70db4dcc331516405b38db950ad2a9621c7ccb19e055a/hexor-0.0.15-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c1c3795e1ce53497e3bf41540fea2b5e6b7aa07aad6887ea0f5d19702d101b6a",
"md5": "ffd29d6367fda04380f761ef487c5e56",
"sha256": "edf0d43115d6f02b858b0531d67b997348fa6f6d93d3c83e83b392b8d8cec1ba"
},
"downloads": -1,
"filename": "hexor-0.0.15.tar.gz",
"has_sig": false,
"md5_digest": "ffd29d6367fda04380f761ef487c5e56",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5919,
"upload_time": "2023-06-06T18:28:24",
"upload_time_iso_8601": "2023-06-06T18:28:24.873182Z",
"url": "https://files.pythonhosted.org/packages/c1/c3/795e1ce53497e3bf41540fea2b5e6b7aa07aad6887ea0f5d19702d101b6a/hexor-0.0.15.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-06 18:28:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yasserbdj96",
"github_project": "hexor",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "hexor"
}