{"id":15009694,"url":"https://github.com/billythegoat356/pystyle","last_synced_at":"2025-04-13T06:28:31.461Z","repository":{"id":39903187,"uuid":"385356024","full_name":"billythegoat356/pystyle","owner":"billythegoat356","description":"The source of my Python library,  pystyle.","archived":false,"fork":false,"pushed_at":"2024-07-28T16:53:12.000Z","size":71,"stargazers_count":209,"open_issues_count":20,"forks_count":16,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-04T04:13:09.948Z","etag":null,"topics":["animatoin","cli","colorama","colors","fade","pip","py","pypi","python","tui"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/pystyle/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/billythegoat356.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-12T19:09:04.000Z","updated_at":"2025-04-01T12:30:30.000Z","dependencies_parsed_at":"2024-09-28T17:01:13.957Z","dependency_job_id":null,"html_url":"https://github.com/billythegoat356/pystyle","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billythegoat356%2Fpystyle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billythegoat356%2Fpystyle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billythegoat356%2Fpystyle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/billythegoat356%2Fpystyle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/billythegoat356","download_url":"https://codeload.github.com/billythegoat356/pystyle/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248674097,"owners_count":21143644,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["animatoin","cli","colorama","colors","fade","pip","py","pypi","python","tui"],"created_at":"2024-09-24T19:27:40.628Z","updated_at":"2025-04-13T06:28:31.440Z","avatar_url":"https://github.com/billythegoat356.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003ePyStyle\u003c/h1\u003e\n\u003cbr\u003e\n\u003cp\u003e\n  \u003cimg alt=\"Version\" src=\"https://img.shields.io/badge/version-1.5-blue.svg?cacheSeconds=2592000\" /\u003e\n  \u003ca href=\"https://github.com/billythegoat356/pystyle/blob/main/README.md\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Documentation\" src=\"https://img.shields.io/badge/documentation-yes-brightgreen.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/billythegoat356/pystyle\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Maintenance\" src=\"https://img.shields.io/badge/Maintained%3F-yes-green.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/billythegoat356/pystyle/blob/main/LICENSE\" target=\"_blank\"\u003e\n    \u003cimg alt=\"License: EPL-2.0\" src=\"https://img.shields.io/github/license/billythegoat356/pystyle\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pepy.tech/project/pystyle\" target=\"_blank\"\u003e\n    \u003cimg alt=\"Downloads\" src=\"https://static.pepy.tech/personalized-badge/pystyle?period=total\u0026units=international_system\u0026left_color=grey\u0026right_color=orange\u0026left_text=Downloads\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e **PyStyle** is a python library to make very beautiful TUI designs.\n\u003e \u003cbr\u003e\n\u003e Inspired by **pyfade** and **pycenter**,\n\u003e \u003cbr\u003e\n\u003e Developped by [Billy](https://github.com/billythegoat356), [loTus01](https://github.com/loTus04), and [BlueRed](https://github.com/CSM-BlueRed)\n\n\n\u003cimg src=\"https://media.discordapp.net/attachments/888138903138213911/888139229681561681/pystylebanner.png\"/\u003e \n\n## Install\n\n```sh\npip3 install pystyle\n```\nStats: https://pepy.tech/project/pystyle\n\n# FEATURES IN THE DOC\n\n  - Colorate text ✔️\n  - Colorate text with fade effect ✔️\n  - Animations ❌\n  - Writing effects ✔️\n  - Centered Text ✔️\n  - Adding banners ✔️\n  - Make boxes ✔️\n  - Hide and Show Cursor ✔️\n  - System Functions ✔️\n\n\u003cbr\u003e\n\n## Colorate text\n\u003cimg src=\"https://cdn.discordapp.com/attachments/882652381731504182/890179524451512330/unknown.png\"\u003e\n\u003cp\u003e\u003ci\u003e\u003cstrong\u003eColorate some text easily.\u003c/strong\u003e\u003c/i\u003e\u003c/p\u003e\n\u003cbr\u003e\n\n```python\nfrom pystyle import Colors, Colorate\ntext = \"Hello world!\"\nprint(Colors.blue + text)\n# or\nprint(Colorate.Color(Colors.blue, text, True))\n```\n\n\u003cbr\u003e\n\n`Colors.blue` = color\u003cbr\u003e\n`text` = text to be colored\u003cbr\u003e\n`True` = end the coloring after (otherwise it will continue printing characters in the specified color)\n\n\u003cbr\u003e\n\nAvailable functions are:\n  - Color (simply colorate a text)\n  - Error (make an error effect easily)\n\n\n\u003cbr\u003e\n\n## Colorate text with fade effect    \n\u003cimg src=\"https://media.discordapp.net/attachments/888138903138213911/888143816836653116/pystleHor.png\"\u003e\n\u003cp\u003e\u003ci\u003e\u003cstrong\u003eMake a fade effect.\u003c/strong\u003e\u003c/i\u003e\u003c/p\u003e\n\u003cbr\u003e\n\n```python\nfrom pystyle import Colors, Colorate\nprint(Colorate.Horizontal(Colors.yellow_to_red, \"Hello, Welcome to Pystyle.\", 1))\n```\n\n\u003cbr\u003e\n\n`Colors.yellow_to_red` = color\u003cbr\u003e\n`Colorate.Vertical` = mode\u003cbr\u003e\n`1` = intensity (default=1)\n\n\u003cbr\u003e\n\nAvailable effects are:\n  - Vertical\n  - Horizontal\n  - Diagonal\n  - DiagonalBackwards\n\n\u003cbr\u003e\n\n## Writing text with fade effect\n\n\u003cbr\u003e\n\nTo print a text with a writing and fade effect you can use the `pystyle.Write` function.\n\n```python\nfrom pystyle import Write, Colors\n\nname = Write.Input(\"Enter your name -\u003e \", Colors.red_to_purple, interval=0.0025)\nWrite.Print(f\"Nice to meet you, {name}!\", Colors.blue_to_green, interval=0.05)\n```\n\u003cbr\u003e\n\n\nThere are 2 functions:\u003cbr\u003e\n\n\n`Write.Print`: prints the text to the terminal with chosen effects\u003cbr\u003e\n`Write.Input`: same than `Write.Print` but adds an input at the end\u003cbr\u003e\n\n\n\u003cbr\u003e\n\n\nThere are 6 arguments:\u003cbr\u003e\n\n\n`text`: the text to be written to the terminal\u003cbr\u003e\n`color`: the color you want for the text\u003cbr\u003e\n`interval`: the interval of the writing effect\u003cbr\u003e\n`hide_cursor`: whether you want the cursor to be hidden or not\u003cbr\u003e\n`end`: the end color, the default is white\u003cbr\u003e\n`input_color` (only for `Write.Input`): the color of the input\u003cbr\u003e\n\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n\n## Center text\n\u003cimg src=\"https://media.discordapp.net/attachments/888138903138213911/888174929386799104/pycenter.png\"\u003e\n\u003cbr\u003e\n\u003cp\u003e\u003ci\u003e\u003cstrong\u003eCenter a text in the terminal.\u003c/strong\u003e\u003c/i\u003e\u003c/p\u003e\n\n```python\nfrom pystyle import Center\nprint(Center.XCenter(\"Hello, Welcome to Pystyle.\"))\n```\n\u003cbr\u003e\n\u003cp\u003eOutput:\u003c/p\u003e\n\u003cbr\u003e\n\n```\n                                            Hello, Welcome to Pystyle.                                \n```\n\n\n\u003cbr\u003e\n\nAvailable modes are:\n  - Center (Center the banner/text on both axis)\n  - XCenter (Center the banner/text on X axis)\n  - YCenter (Center the banner/text on Y axis)\n\n\u003cbr\u003e\u003cbr\u003e\n\n## Adding banners\n\u003cp\u003e\u003ci\u003e\u003cstrong\u003eAdd a banner to another easily.\u003c/strong\u003e\u003c/i\u003e\u003c/p\u003e\n\u003cimg src=\"https://media.discordapp.net/attachments/888138903138213911/888139239357816842/addbanner.png\" width=\"479\" height=\"222\"/\u003e\n\n```python\nfrom pystyle import Add\nbanner1 = '''\n    .--.\n  .'_\\/_'.\n  '. /\\ .'\n    \"||\"\n     || /\\\n  /\\ ||//\\)\n (/\\\\||/\n____\\||/____'''\n\ntext = \"This is a beautiful banner\\nmade with pystyle\"\n\nprint(Add.Add(banner1, text, 4))\n```\n\nOutput:\n\n```\n    .--.\n  .'_\\/_'.\n  '. /\\ .'\n    \"||\"    This is a beautiful banner\n     || /\\  made with pystyle\n  /\\ ||//\\)\n (/\\||/\n____\\||/____\n```\n\u003cbr\u003e\n\n`banner1` = first banner\u003cbr\u003e\n`text` = second banner\u003cbr\u003e\n`4` = blank lines before adding the smallest banner to the biggest banner (default=0). Set to `True` to center it\u003cbr\u003e\n\n## Make boxes\n\u003cp\u003e\u003ci\u003e\u003cstrong\u003eMake beautiful boxes easily!\u003c/strong\u003e\u003c/i\u003e\u003c/p\u003e\n\u003cbr\u003e\n\n```python\nfrom pystyle import Box\nprint(Box.Lines(\"Hello, Welcome to Pystyle.\"))\nprint(Box.DoubleCube(\"Hello, Welcome to Pystyle.\"))\n```\n\nOutput:\n\n```\n─══════════════════════════☆☆══════════════════════════─\n               Hello, Welcome to Pystyle.\n─══════════════════════════☆☆══════════════════════════─\n╔════════════════════════════╗\n║ Hello, Welcome to Pystyle. ║\n╚════════════════════════════╝\n```\n\nAvailable modes are:\n  - Lines\n  - SimpleCube\n  - DoubleCube\n\n## Cursor\nShow cursor!\n\n```python\nfrom pystyle import Cursor\n\nCursor.ShowCursor()\n```\n\nHide cursor!\n\n```python\nfrom pystyle import Cursor\n\nCursor.HideCursor()\n```\n\n## System functions\n### Check the terminal support colors\n```python\nfrom pystyle import System\n\nSystem.Init()\n```\n### Clear the terminal screen\n```python\nfrom pystyle import System\n\nSystem.Clear()\n```\n### Change the terminal title\n```python\nfrom pystyle import System\n\nSystem.Title(\"The title\")\n```\n**Notice: this feature only work on windows**\n### Change terminal size\n\n**Notice** This feature is only working on windows\n\n```python\nfrom pystyle import System\n\nSystem.Size(12,12)\n```\n### Run a shell command\n```python\nfrom pystyle import System\n\nSystem.Command(\"echo hello\")\n```\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n## 👤 Authors\n\n👤 GitHub: [@**billythegoat356**](https://github.com/billythegoat356)\u003cbr\u003e\n👤 GitHub: [@**loTus01**](https://github.com/loTus04)\u003cbr\u003e\n👤 GitHub: [@**BlueRed**](https://github.com/CSM-BlueRed)\u003cbr\u003e\n\n## 🤝 Contributing\n\nContributions, issues and feature requests are welcome!\u003cbr /\u003eFeel free to check [issues page](https://github.com/billythegoat356/pystyle/issues).\n\n## ❤ Show your support\n\nGive a ⭐️ if this project helped you!\n\n\n***\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbillythegoat356%2Fpystyle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbillythegoat356%2Fpystyle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbillythegoat356%2Fpystyle/lists"}