{"id":42960794,"url":"https://github.com/iskaa02/qalam","last_synced_at":"2026-01-30T23:05:20.029Z","repository":{"id":57651437,"uuid":"448899061","full_name":"iskaa02/qalam","owner":"iskaa02","description":"an easy to use terminal styling library","archived":false,"fork":false,"pushed_at":"2022-05-11T12:35:26.000Z","size":250,"stargazers_count":42,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-06-19T01:11:54.594Z","etag":null,"topics":["ansi","go","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","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/iskaa02.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-01-17T13:11:39.000Z","updated_at":"2024-06-19T01:11:54.595Z","dependencies_parsed_at":"2022-09-26T20:30:56.205Z","dependency_job_id":null,"html_url":"https://github.com/iskaa02/qalam","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/iskaa02/qalam","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iskaa02%2Fqalam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iskaa02%2Fqalam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iskaa02%2Fqalam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iskaa02%2Fqalam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iskaa02","download_url":"https://codeload.github.com/iskaa02/qalam/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iskaa02%2Fqalam/sbom","scorecard":{"id":495615,"data":{"date":"2025-08-11","repo":{"name":"github.com/iskaa02/qalam","commit":"bf03c9d7a61ef977ac6f0b680216fa580b3299fd"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.9,"checks":[{"name":"Code-Review","score":0,"reason":"Found 0/29 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE.txt:0","Info: FSF or OSI recognized license: MIT License: LICENSE.txt:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":9,"reason":"1 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2022-0603 / GHSA-hp87-p4gw-j4gq"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-19T20:22:11.389Z","repository_id":57651437,"created_at":"2025-08-19T20:22:11.390Z","updated_at":"2025-08-19T20:22:11.390Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28922232,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T22:32:35.345Z","status":"ssl_error","status_checked_at":"2026-01-30T22:32:31.927Z","response_time":66,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["ansi","go","golang"],"created_at":"2026-01-30T23:05:19.386Z","updated_at":"2026-01-30T23:05:20.021Z","avatar_url":"https://github.com/iskaa02.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv id=\"top\"\u003e\u003c/div\u003e\n\u003c!--\n*** Thanks for checking out the Best-README-Template. If you have a suggestion\n*** that would make this better, please fork the repo and create a pull request\n*** or simply open an issue with the tag \"enhancement\".\n*** Don't forget to give the project a star!\n*** Thanks again! Now go create something AMAZING! :D\n--\u003e\n\n\u003c!-- PROJECT SHIELDS --\u003e\n\u003c!--\n*** I'm using markdown \"reference style\" links for readability.\n*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).\n*** See the bottom of this document for the declaration of the reference variables\n*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.\n*** https://www.markdownguide.org/basic-syntax/#reference-style-links\n--\u003e\n\n[![Contributors][contributors-shield]][contributors-url]\n[![Forks][forks-shield]][forks-url]\n[![Stargazers][stars-shield]][stars-url]\n[![Issues][issues-shield]][issues-url]\n[![MIT License][license-shield]][license-url]\n\n\u003c!-- PROJECT LOGO --\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/iskaa02/qalam\"\u003e\n    \u003ch1\u003e✏️\u003c/h1\u003e\n  \u003c/a\u003e\n\n\u003ch2 align=\"center\"\u003eQalam\u003c/h2\u003e\n  \u003cp align=\"center\"\u003e\n    Easy Terminal styling using go\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"https://github.com/iskaa02/qalam/issues\"\u003eReport Bug\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/iskaa02/qalam/issues\"\u003eRequest Feature\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#styler\"\u003eUsing Styler\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#bbcode\"\u003eUsing BBcode\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#bbcode-examples\"\u003eBBcode Exmaples\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#gradient\"\u003eGradient\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#notes\"\u003eNotes\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\u003c!-- ABOUT THE PROJECT --\u003e\n\n## About The Project\n\n![Example for what qalam can do](./doc/images/qalam_example.png)\n\nQalam is A terminal Styling library built for Go to make building cool-looking CLIs easier\n\n### IMPORTANT\n\nThe project still in early state it might have breaking changes in the future\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Getting Started\n\nThere is Two Ways to use Qalam\n\n1. Using [Styler](#with-styler)\n2. Using [BBcode format](#with-bbcode-format)\n\n### Installation\n\n```bash\ngo get github.com/iskaa02/qalam\n```\n\n## Usage\n\n### With Styler\n\n```go\nimport \"github.com/iskaa02/qalam\"\nfunc main(){\n\ts:=qalam.NewStyler().\n\t\tBold().\n\t\tItalic().\n\t\tRed()\n\t// This will print bold italic red text to the terminal\n\ts.Print(\"Hello world\")\n\n\t// Change background color\n\ts.YellowBackground()\n\n\t// use hex color as foreground color\n\ts.Hex(\"#e28421\")\n\n\t// use hex color as background color\n\ts.BackgroundHex(\"#e28421\")\n\n\t// Flip Foreground and background colors\n\ts.Invert()\n\n\t// Make Text blink\n\ts.Blink()\n\n}\n```\n\nRemoving Styles\n\n```go\n// You can remove any style added previously\n s.Remove(\"bold\",\"blink\",\"bg#e28421\")\n```\n\nreference [code table](#code-table) below\n\n### With BBcode Format\n\n```go\nimport \"github.com/iskaa02/qalam/bbcode\"\nfunc main(){\n\t// this will output \"a red text\" with red in terminal\n\t// you can use bbcode.Sprintf() if you don't want to print yet\n\tbbcode.Printf(\"[red]a red %s[/red]\",\"text\")\n}\n```\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## BBcode Examples\n\n### Multiple styles\n\n```go\nbbcode.Printf(\"[b s]bold and strikethrough[/b s]\")\n```\n\noutputs:\n~~**bold and strikethrough**~~\n\n\u003cbr/\u003e\n\n### Composing styles\n\n```go\nbbcode.Printf(\"[b]bold only [i]bold and italic[/i][/b]\")\n```\n\noutputs:\n**bold only** **_bold and italic_**\n\n\u003cbr/\u003e\n\n## Code Table\n\n| Code            | Style                                                    |\n| --------------- | -------------------------------------------------------- |\n| b/bold          | **bold text**                                            |\n| i/italic        | _italic text_                                            |\n| u/underline     | underline text                                           |\n| s/strikethrough | ~~strikethrough text~~                                   |\n| #hexcode        | change the color                                         |\n| bg#hexcode      | change the background color                              |\n| red             | change the color to red                                  |\n| yellow          | change the color to yellow                               |\n| magenta         | change the color to magenta                              |\n| white           | change the color to white                                |\n| black           | change the color to black                                |\n| green           | change the color to green                                |\n| cyan            | change the color to cyan                                 |\n| bg.(color)      | change the background color to any color mentioned above |\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Gradient\n\n### Import\n\n```go\nimport \"github.com/iskaa02/qalam/gradient\"\n```\n\n### Usage\n\n```go\ng,err:=gradient.NewGradient(\"cyan\",\"red\")\n// if the passed colors are not valid an error is returned\n// supports all css valid colors\nif err != nil{\n}\ng.Print(\"Example gradient from Cyan to Red\")\n```\n\noutputs the following\n\n![gradient Example](./doc/images/gradient_example1.png)\n\nFor more examples [checkout gradient Readme](https://github.com/iskaa02/qalam/blob/main/gradient/README.MD)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- LICENSE --\u003e\n\n## License\n\nDistributed under the MIT License. See `LICENSE.txt` for more information.\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n## Notes\n\n### Windows Support\n\nIf you're on Windows, use [Windows Terminal](https://github.com/microsoft/terminal) instead of cmd.exe.\n\n#\n\n### What does the Qalam mean\n\nQalam in Arabic means pencil\n\n\u003cbr /\u003e\n\n# Contact\n\nIsmael Karim - ismael.karim000@gmail.com\n\nProject Link: [https://github.com/iskaa02/qalam](https://github.com/iskaa02/qalam)\n\n\u003cp align=\"right\"\u003e(\u003ca href=\"#top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax/#reference-style-links --\u003e\n\n[contributors-shield]: https://img.shields.io/github/contributors/iskaa02/qalam.svg?style=for-the-badge\n[contributors-url]: https://github.com/iskaa02/qalam/graphs/contributors\n[forks-shield]: https://img.shields.io/github/forks/iskaa02/qalam.svg?style=for-the-badge\n[forks-url]: https://github.com/iskaa02/qalam/network/members\n[stars-shield]: https://img.shields.io/github/stars/iskaa02/qalam.svg?style=for-the-badge\n[stars-url]: https://github.com/iskaa02/qalam/stargazers\n[issues-shield]: https://img.shields.io/github/issues/iskaa02/qalam.svg?style=for-the-badge\n[issues-url]: https://github.com/iskaa02/qalam/issues\n[license-shield]: https://img.shields.io/github/license/iskaa02/qalam.svg?style=for-the-badge\n[license-url]: https://github.com/iskaa02/qalam/blob/master/LICENSE.txt\n[linkedin-shield]: https://img.shields.io/badge/-LinkedIn-black.svg?style=for-the-badge\u0026logo=linkedin\u0026colorB=555\n[linkedin-url]: https://linkedin.com/in/linkedin_username\n[product-screenshot]: images/screenshot.png\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiskaa02%2Fqalam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiskaa02%2Fqalam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiskaa02%2Fqalam/lists"}