{"id":23619482,"url":"https://github.com/XulbuX/PythonLibraryXulbuX","last_synced_at":"2025-08-30T22:30:28.181Z","repository":{"id":262336404,"uuid":"886930854","full_name":"XulbuX/PythonLibraryXulbuX","owner":"XulbuX","description":"A Python library which includes lots of helpful classes, types, and functions aiming to make common programming tasks simpler.","archived":false,"fork":false,"pushed_at":"2025-08-29T08:02:51.000Z","size":644,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-29T12:07:34.994Z","etag":null,"topics":["classes","functions","libraries","methods","python","python-library-xulbux","types","useful"],"latest_commit_sha":null,"homepage":"","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/XulbuX.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["XulbuX"],"open_collective":null,"custom":["https://www.paypal.me/XulbuX"]}},"created_at":"2024-11-11T21:39:36.000Z","updated_at":"2025-08-29T08:02:54.000Z","dependencies_parsed_at":"2024-11-11T22:31:39.599Z","dependency_job_id":"3e1730df-0a42-459e-a202-1d6a74ec4c9f","html_url":"https://github.com/XulbuX/PythonLibraryXulbuX","commit_stats":null,"previous_names":["xulbux-dev/python-library-xulbux","xulbux/pythonlibraryxulbux"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/XulbuX/PythonLibraryXulbuX","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XulbuX%2FPythonLibraryXulbuX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XulbuX%2FPythonLibraryXulbuX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XulbuX%2FPythonLibraryXulbuX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XulbuX%2FPythonLibraryXulbuX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/XulbuX","download_url":"https://codeload.github.com/XulbuX/PythonLibraryXulbuX/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XulbuX%2FPythonLibraryXulbuX/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272839674,"owners_count":25001862,"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","status":"online","status_checked_at":"2025-08-30T02:00:09.474Z","response_time":77,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["classes","functions","libraries","methods","python","python-library-xulbux","types","useful"],"created_at":"2024-12-27T19:51:33.619Z","updated_at":"2025-08-30T22:30:28.173Z","avatar_url":"https://github.com/XulbuX.png","language":"Python","readme":"# **XulbuX**\n\n[![](https://img.shields.io/pypi/v/xulbux?labelColor=404560\u0026color=7075FF)](https://pypi.org/project/xulbux) [![](https://img.shields.io/pepy/dt/xulbux?labelColor=404560\u0026color=7075FF)](https://clickpy.clickhouse.com/dashboard/xulbux) [![](https://img.shields.io/github/license/XulbuX/PythonLibraryXulbuX?labelColor=405555\u0026color=70FFEE)](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE) [![](https://img.shields.io/github/last-commit/XulbuX/PythonLibraryXulbuX?labelColor=554045\u0026color=FF6065)](https://github.com/XulbuX/PythonLibraryXulbuX/commits) [![](https://img.shields.io/github/issues/XulbuX/PythonLibraryXulbuX?labelColor=554045\u0026color=FF6065)](https://github.com/XulbuX/PythonLibraryXulbuX/issues)\n\n**XulbuX** is a library that contains many useful classes, types, and functions,\nranging from console logging and working with colors to file management and system operations.\nThe library is designed to simplify common programming tasks and improve code readability through its collection of tools.\n\nFor precise information about the library, see the library's [**documentation**](https://github.com/XulbuX/PythonLibraryXulbuX/wiki).\u003cbr\u003e\nFor the libraries latest changes and updates, see the [**change log**](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md).\n\n### The best modules, you have to check out:\n\n[![format_codes](https://img.shields.io/badge/format__codes-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/format_codes) [![console](https://img.shields.io/badge/console-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/console) [![color](https://img.shields.io/badge/color-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/color)\n\n\u003cbr\u003e\n\n## Installation\n\nRun the following commands in a console with administrator privileges, so the actions take effect for all users.\n\nInstall the library and all its dependencies with the command:\n```console\npip install xulbux\n```\n\nUpgrade the library and all its dependencies to their latest available version with the command:\n```console\npip install --upgrade xulbux\n```\n\n\u003cbr\u003e\n\n## CLI Commands\n\nWhen the library is installed, the following commands are available in the console:\n| Command       | Description                              |\n| :------------ | :--------------------------------------- |\n| `xulbux-help` | shows some information about the library |\n\n\u003cbr\u003e\n\n## Usage\n\nImport the full library under the alias `xx`, so its constants, classes, methods, and types are accessible with `xx.CONSTANT.value`, `xx.Class.method()`, `xx.type()`:\n```python\nimport xulbux as xx\n```\nSo you don't have to import the full library under an alias, you can also import only certain parts of the library's contents:\n```python\n# LIBRARY CONSTANTS\nfrom xulbux.base.consts import COLOR, CHARS, ANSI\n# Main Classes\nfrom xulbux import Code, Color, Console, ...\n# module specific imports\nfrom xulbux.color import rgba, hsla, hexa\n```\n\n\u003cbr\u003e\n\n## Modules\n\n| Module                                                                                                                                                    | Short Description                                                                           |\n| :-------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------ |\n| [![base](https://img.shields.io/badge/base-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/base)                          | includes more modules like library constants                                                |\n| [![code](https://img.shields.io/badge/code-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/code)                          | advanced code-string operations (*changing the indent, finding function calls, ...*)        |\n| [![color](https://img.shields.io/badge/color-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/color)                       | everything around colors (*converting, blending, searching colors in strings, ...*)         |\n| [![console](https://img.shields.io/badge/console-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/console)                 | advanced actions related to the console (*pretty logging, advanced inputs, ...*)            |\n| [![data](https://img.shields.io/badge/data-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/data)                          | advanced operations with data structures (*compare, generate path IDs, pretty print, ...*)  |\n| [![env_path](https://img.shields.io/badge/env__path-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/env_path)             | getting and editing the PATH variable (*get paths, check for paths, add paths, ...*)        |\n| [![file](https://img.shields.io/badge/file-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/file)                          | advanced working with files (*create files, rename file-extensions, ...*)                   |\n| [![format_codes](https://img.shields.io/badge/format__codes-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/format_codes) | easy pretty printing using custom format codes (*print, inputs, format codes to ANSI, ...*) |\n| [![json](https://img.shields.io/badge/json-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/json)                          | advanced working with json files (*read, create, update, ...*)                              |\n| [![path](https://img.shields.io/badge/path-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/path)                          | advanced path operations (*get paths, smart-extend relative paths, delete paths, ...*)      |\n| [![regex](https://img.shields.io/badge/regex-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/regex)                       | generated regex pattern-templates (*match bracket- and quote pairs, match colors, ...*)     |\n| [![string](https://img.shields.io/badge/string-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/string)                    | helpful actions when working with strings. (*normalize, escape, decompose, ...*)            |\n| [![system](https://img.shields.io/badge/system-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/system)                    | advanced system actions (*restart with message, check installed Python libs, ...*)          |\n\n\u003cbr\u003e\n\n## Example Usage\n\nThis is what it could look like using this library for a simple but ultra good-looking color converter:\n```python\nfrom xulbux.base.consts import COLOR, CHARS\nfrom xulbux.color import hexa\nfrom xulbux import Console\n\n\ndef main() -\u003e None:\n\n    # LET THE USER ENTER A HEXA COLOR IN ANY HEXA FORMAT\n    input_clr = Console.input(\n        \"[b](Enter a HEXA color in any format) \u003e \",\n        start=\"\\n\",\n        placeholder=\"#7075FF\",\n        max_len=7,\n        allowed_chars=CHARS.HEX_DIGITS,\n    )\n\n    # ANNOUNCE INDEXING THE INPUT COLOR\n    Console.log(\n        \"INDEX\",\n        \"Indexing the input HEXA color...\",\n        start=\"\\n\",\n        title_bg_color=COLOR.BLUE,\n    )\n\n    try:\n        # TRY TO CONVERT THE INPUT COLOR INTO A hexa() COLOR\n        hexa_color = hexa(input_clr)\n\n    except ValueError:\n        # ANNOUNCE THE ERROR AND EXIT THE PROGRAM\n        Console.fail(\n            \"The input HEXA color is invalid.\",\n            end=\"\\n\\n\",\n            exit=True,\n        )\n\n    # ANNOUNCE STARTING THE CONVERSION\n    Console.log(\n        \"CONVERT\",\n        \"Converting the HEXA color into different types...\",\n        title_bg_color=COLOR.TANGERINE,\n    )\n\n    # CONVERT THE HEXA COLOR INTO THE TWO OTHER COLOR TYPES\n    rgba_color = hexa_color.to_rgba()\n    hsla_color = hexa_color.to_hsla()\n\n    # ANNOUNCE THE SUCCESSFUL CONVERSION\n    Console.done(\n        \"Successfully converted color into different types.\",\n        end=\"\\n\\n\",\n    )\n\n    # PRETTY PRINT THE COLOR IN DIFFERENT TYPES\n    Console.log_box_bordered(\n        f\"[b](HEXA:) [i|white]({hexa_color})\",\n        f\"[b](RGBA:) [i|white]({rgba_color})\",\n        f\"[b](HSLA:) [i|white]({hsla_color})\",\n    )\n\n\nif __name__ == \"__main__\":\n    main()\n```\n\n\u003cbr\u003e\n\u003cbr\u003e\n\n--------------------------------------------------------------\n[View this library on **PyPI**](https://pypi.org/project/xulbux)\n","funding_links":["https://github.com/sponsors/XulbuX","https://www.paypal.me/XulbuX"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXulbuX%2FPythonLibraryXulbuX","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FXulbuX%2FPythonLibraryXulbuX","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXulbuX%2FPythonLibraryXulbuX/lists"}