{"id":14128665,"url":"https://github.com/frostming/python-cfonts","last_synced_at":"2025-04-04T16:14:34.830Z","repository":{"id":32627844,"uuid":"138149915","full_name":"frostming/python-cfonts","owner":"frostming","description":"Sexy fonts for the console","archived":false,"fork":false,"pushed_at":"2024-04-01T20:18:54.000Z","size":284,"stargazers_count":187,"open_issues_count":3,"forks_count":8,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-04-14T06:06:08.399Z","etag":null,"topics":["cli","click","command-line-app","command-line-tools","terminal-colors"],"latest_commit_sha":null,"homepage":"https://python-cfonts.fming.dev","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/frostming.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://www.buymeacoffee.com/frostming"]}},"created_at":"2018-06-21T09:33:57.000Z","updated_at":"2024-03-30T06:10:21.000Z","dependencies_parsed_at":"2024-04-01T21:29:49.841Z","dependency_job_id":"1b70b84b-6eda-4d52-b975-6125aba620c4","html_url":"https://github.com/frostming/python-cfonts","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frostming%2Fpython-cfonts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frostming%2Fpython-cfonts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frostming%2Fpython-cfonts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/frostming%2Fpython-cfonts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/frostming","download_url":"https://codeload.github.com/frostming/python-cfonts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247208146,"owners_count":20901570,"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":["cli","click","command-line-app","command-line-tools","terminal-colors"],"created_at":"2024-08-15T16:02:01.289Z","updated_at":"2025-04-04T16:14:34.798Z","avatar_url":"https://github.com/frostming.png","language":"Python","funding_links":["https://www.buymeacoffee.com/frostming"],"categories":["Python"],"sub_categories":[],"readme":"```\n  ██████╗ ███████╗  ██████╗  ███╗   ██╗ ████████╗ ███████╗\n ██╔════╝ ██╔════╝ ██╔═══██╗ ████╗  ██║ ╚══██╔══╝ ██╔════╝\n ██║      █████╗   ██║   ██║ ██╔██╗ ██║    ██║    ███████╗\n ██║      ██╔══╝   ██║   ██║ ██║╚██╗██║    ██║    ╚════██║\n ╚██████╗ ██║      ╚██████╔╝ ██║ ╚████║    ██║    ███████║\n  ╚═════╝ ╚═╝       ╚═════╝  ╚═╝  ╚═══╝    ╚═╝    ╚══════╝\n```\n\n![Tests](https://github.com/frostming/python-cfonts/workflows/Tests/badge.svg)\n\n_This is a Python port of [cfonts](https://github.com/dominikwilkowski/cfonts). Thanks for the original code and beautiful console fonts!_\n\n\u003e **NOTE:** This project supports Python 3.6+\n\n## Installation\n\n```bash\n$ pip install python-cfonts\n```\n\n## Usage\n\n[Documentation](https://python-cfonts.fming.dev/)\n\nCommand line interface:\n\n```bash\nusage: cfonts [-h] [-V]\n              [-f {console,block,simpleBlock,simple,3d,simple3d,chrome,huge,grid,pallet,shade,slick}]\n              [-c COLORS] [-b BACKGROUND] [-a {left,center,right}]\n              [-l LETTER_SPACING] [-z LINE_HEIGHT] [-s] [-m MAX_LENGTH]\n              [-g GRADIENT] [-i] [-t]\n              text\n\npositional arguments:\n  text\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -V, --version         show program's version number and exit\n  -f {console,block,simpleBlock,simple,3d,simple3d,chrome,huge,grid,pallet,shade,slick}, --font {console,block,simpleBlock,simple,3d,simple3d,chrome,huge,grid,pallet,shade,slick}\n                        Use to define the font face\n  -c COLORS, --colors COLORS\n                        Use to define the font color\n  -b BACKGROUND, --background BACKGROUND\n                        Use to define the background color\n  -a {left,center,right}, --align {left,center,right}\n                        Use to align the text output\n  -l LETTER_SPACING, --letter-spacing LETTER_SPACING\n                        Use to define the letter spacing\n  -z LINE_HEIGHT, --line-height LINE_HEIGHT\n                        Use to define the line height\n  -s, --spaceless       Use to define the background color\n  -m MAX_LENGTH, --max-length MAX_LENGTH\n                        Use to define the amount of maximum characters per\n                        line\n  -g GRADIENT, --gradient GRADIENT\n                        Define gradient colors(separated by comma)\n  -i, --independent-gradient\n                        Set this option to re-calculate the gradient colors\n                        for each new line.Only works in combination with the\n                        gradient option.\n  -t, --transition-gradient\n                        Set this option to generate your own gradients. Each\n                        color set in the gradient option will then be\n                        transitioned to directly.\n```\n\n![](https://python-cfonts.fming.dev/_images/example.png)\n\nOr generate the fonts pragramatically:\n\n```python\nfrom cfonts import render, say\n\noutput = render('Hello world', colors=['red', 'yellow'], align='center')\nprint(output)\n```\n\n## Supported Characters\n\n|     |     |     |     |            |\n| --- | --- | --- | --- | ---------- |\n| `A` | `O` | `2` | `2` | `=`        |\n| `B` | `P` | `3` | `3` | `@`        |\n| `C` | `Q` | `4` | `4` | `#`        |\n| `D` | `R` | `5` | `5` | `$`        |\n| `E` | `S` | `6` | `6` | `%`        |\n| `F` | `T` | `7` | `7` | `\u0026`        |\n| `G` | `U` | `8` | `8` | `(`        |\n| `H` | `V` | `9` | `9` | `)`        |\n| `I` | `W` | `!` | `!` | `/`        |\n| `J` | `X` | `?` | `?` | `:`        |\n| `K` | `Y` | `.` | `.` | `;`        |\n| `L` | `Z` | `+` | `+` | `,`        |\n| `M` | `0` | `-` | `-` | `'`        |\n| `N` | `1` | `_` | `_` | `` (space) |\n| `\"` |\n\n## Contributing\n\n`python-cfonts` is managed by [pdm](https://github.com/frostming/pdm), first install it:\n\n```bash\npipx install pdm\n```\n\nThen, install a dependencies:\n\n```bash\npdm install -d\n```\n\nRun tests:\n\n```bash\n$ pdm run pytest tests\n```\n\n## License\n\nThe project is originated by [@dominikwilkowski](https://github.com/dominikwilkowski), under GPLv2 license.\nPorted by [@frostming](https://github.com/frostming), under MIT license. See [LICENSE](/LICENSE) for details\n\n## Changelog\n\n- **v1.5.2** Fix the RGB color codes for truecolor system.\n- **v1.5.1**\n  - Fix the truecolor display on Windows.\n  - Enable truecolor by default for Windows Terminal.\n  - Add type hints for the codebase.\n- **v1.5.0** Officially drop support of Python 2.7\n- **v1.4.0** Officially drop support of Python 3.5\n- **v1.3.1** Fix the sdist.\n- **v1.3.0** Relicense to MIT.\n- **v1.2.0** Add font `tiny`.\n- **v1.1.0** Switch to `argparse` to drop dependency `click`.\n- **v1.0.0** Support gradient colors and transition gradient.\n- **v0.5.0** Add four new fonts and double quote as supported charater.\n- **v0.3.1** Fix a bug that the background doesn't span the full width.\n- **v0.3.0** Supports Python 2.7.\n- **v0.2.0** Initial commit and testing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrostming%2Fpython-cfonts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffrostming%2Fpython-cfonts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffrostming%2Fpython-cfonts/lists"}