{"id":17034663,"url":"https://github.com/liba001/disputils","last_synced_at":"2025-04-09T17:26:35.197Z","repository":{"id":46574739,"uuid":"169900101","full_name":"LiBa001/disputils","owner":"LiBa001","description":"Some neat utils for discord.py. Making your life as a Discord bot developer easier.  (not sure about the future of this libraray)","archived":false,"fork":false,"pushed_at":"2024-05-07T22:15:34.000Z","size":93,"stargazers_count":99,"open_issues_count":5,"forks_count":25,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-02T15:09:04.158Z","etag":null,"topics":["bot","bots","botsfordiscord","discord","discord-bot","discord-py","discord-py-rewrite","utility","utils","utils-lib","utils-library"],"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/LiBa001.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2019-02-09T18:39:21.000Z","updated_at":"2024-07-19T13:07:59.000Z","dependencies_parsed_at":"2024-06-18T22:56:57.091Z","dependency_job_id":"e9413f36-3045-4331-be98-ae4c20d5b603","html_url":"https://github.com/LiBa001/disputils","commit_stats":{"total_commits":44,"total_committers":10,"mean_commits":4.4,"dds":0.6136363636363636,"last_synced_commit":"313404e02c781a999c44d7f3e87548c01e9cc7da"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiBa001%2Fdisputils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiBa001%2Fdisputils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiBa001%2Fdisputils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LiBa001%2Fdisputils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LiBa001","download_url":"https://codeload.github.com/LiBa001/disputils/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248076275,"owners_count":21043742,"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":["bot","bots","botsfordiscord","discord","discord-bot","discord-py","discord-py-rewrite","utility","utils","utils-lib","utils-library"],"created_at":"2024-10-14T08:44:16.806Z","updated_at":"2025-04-09T17:26:35.177Z","avatar_url":"https://github.com/LiBa001.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":".. image:: https://badge.fury.io/py/disputils.svg\n    :target: https://pypi.org/project/disputils\n    :alt: PyPI\n\n.. image:: https://img.shields.io/github/license/LiBa001/disputils\n    :target: https://github.com/LiBa001/disputils/blob/master/LICENSE\n    :alt: License\n\n.. image:: https://readthedocs.org/projects/disputils/badge/?version=latest\n    :target: https://disputils.readthedocs.io/en/latest/?badge=latest\n    :alt: Documentation\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n    :target: https://github.com/psf/black\n\n*********\nDisputils\n*********\n\nDisputils provides some neat features to make your life as a bot developer easier.\n\n\nInstall\n#######\n\nInstall latest release from PyPI_ via pip:\n\n.. code-block:: bash\n\n    python3.6 -m pip install disputils\n\nOr the freshest bleeding-edge code directly from GitHub_ using pip and git:\n\n.. code-block:: bash\n\n    python3.6 -m pip install -U git+https://github.com/LiBa001/disputils\n\n\n.. note::\n\n    A compatible version of `discord.py` will be installed automatically when\n    downloading with pip. However, you should still require `discord.py` in\n    your own setup.py or requirements.txt file.\n\n\nFeatures\n########\n\nQuick overview of the available features.\n\nFor all features there are two ways to use them.\n\n* just discord.py and a basic ``discord.Client``\n* discord.py commands extension (``discord.ext.commands``) and a ``Bot``\n\nIn the following examples we're going to use the second way since it's a bit easier.\n\n.. code-block:: py\n\n    from disputils import BotEmbedPaginator, BotConfirmation, BotMultipleChoice\n\n\nPagination\n**********\n\nSplit your content into multiple pages and use reactions to paginate through.\n\n.. code-block:: py\n\n    @bot.command()\n    async def paginate(ctx):\n        embeds = [\n            Embed(title=\"test page 1\", description=\"This is just some test content!\", color=0x115599),\n            Embed(title=\"test page 2\", description=\"Nothing interesting here.\", color=0x5599ff),\n            Embed(title=\"test page 3\", description=\"Why are you still here?\", color=0x191638)\n        ]\n\n        paginator = BotEmbedPaginator(ctx, embeds)\n        await paginator.run()\n\n.. image:: https://raw.githubusercontent.com/LiBa001/disputils/master/docs/img/paginate.png\n\n\nMultiple Choice\n***************\n\nLet the user decide. Provide multiple choice!\n\n.. code-block:: py\n\n    @bot.command()\n    async def choice(ctx):\n        multiple_choice = BotMultipleChoice(ctx, ['one', 'two', 'three', 'four', 'five', 'six'], \"Testing stuff\")\n        await multiple_choice.run()\n\n        await multiple_choice.quit(multiple_choice.choice)\n\n.. image:: https://raw.githubusercontent.com/LiBa001/disputils/master/docs/img/choice.png\n\n\nConfirmation\n************\n\nIs the user going to do something irreversible? Let him confirm first!\n\n.. code-block:: py\n\n    @bot.command()\n    async def confirm(ctx):\n        confirmation = BotConfirmation(ctx, 0x012345)\n        await confirmation.confirm(\"Are you sure?\")\n\n        if confirmation.confirmed:\n            await confirmation.update(\"Confirmed\", color=0x55ff55)\n        else:\n            await confirmation.update(\"Not confirmed\", hide_author=True, color=0xff5555)\n\n.. image:: https://raw.githubusercontent.com/LiBa001/disputils/master/docs/img/confirm.png\n\n\nRequirements\n############\n\n* Python \u003e= 3.6\n* `discord.py \u003e= v1.0.0 (rewrite)`_\n\n\n.. _discord.py \u003e= v1.0.0 (rewrite): https://discordpy.readthedocs.io/en/latest/migrating.html\n.. _PyPI: https://pypi.org/project/disputils/\n.. _GitHub: https://github.com/LiBa001/disputils\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliba001%2Fdisputils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliba001%2Fdisputils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliba001%2Fdisputils/lists"}