{"id":13410771,"url":"https://github.com/HuyaneMatsu/hata","last_synced_at":"2025-03-14T16:33:13.975Z","repository":{"id":37470957,"uuid":"228874597","full_name":"HuyaneMatsu/hata","owner":"HuyaneMatsu","description":"Async Discord API wrapper.","archived":false,"fork":false,"pushed_at":"2024-10-05T10:06:58.000Z","size":28066,"stargazers_count":179,"open_issues_count":0,"forks_count":21,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-10-05T10:19:18.960Z","etag":null,"topics":["api","api-wrapper","async","bot","discord","discord-api","discord-api-wrapper","hata","python","scarletio","slash-commands"],"latest_commit_sha":null,"homepage":"https://www.astil.dev/project/hata/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HuyaneMatsu.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":"CONTRIBUTING.md","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":"2019-12-18T15:58:49.000Z","updated_at":"2024-10-05T10:07:02.000Z","dependencies_parsed_at":"2023-10-05T03:01:23.894Z","dependency_job_id":"96e8a90a-ee64-4cfd-9174-b154ac23d38c","html_url":"https://github.com/HuyaneMatsu/hata","commit_stats":{"total_commits":1456,"total_committers":15,"mean_commits":97.06666666666666,"dds":"0.13736263736263732","last_synced_commit":"8d2c9419e134814d3784dbca69a8f956117eb631"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HuyaneMatsu%2Fhata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HuyaneMatsu%2Fhata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HuyaneMatsu%2Fhata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HuyaneMatsu%2Fhata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HuyaneMatsu","download_url":"https://codeload.github.com/HuyaneMatsu/hata/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243610529,"owners_count":20318980,"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":["api","api-wrapper","async","bot","discord","discord-api","discord-api-wrapper","hata","python","scarletio","slash-commands"],"created_at":"2024-07-30T20:01:09.040Z","updated_at":"2025-03-14T16:33:13.937Z","avatar_url":"https://github.com/HuyaneMatsu.png","language":"Python","funding_links":[],"categories":["API Libraries","Libraries"],"sub_categories":["Python"],"readme":"\u003ch1 align=\"center\"\u003e\n    \u003cb\u003e\n        \u003ca href=\"https://github.com/HuyaneMatsu/hata\"\u003e\n            Hata\n        \u003c/a\u003e\n    \u003c/b\u003e\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003cb\u003e\n        A blazing fast Discord API wrapper that you can't deny\n    \u003c/b\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://discord.gg/3cH2r5d\"\u003eSupport Guild\u003c/a\u003e |\n    \u003ca href=\"https://github.com/HuyaneMatsu/hata/tree/master/docs/topics\"\u003eTopical documentation\u003c/a\u003e |\n    \u003ca href=\"https://github.com/HuyaneMatsu/hata/tree/master/docs/examples\"\u003eExamples\u003c/a\u003e |\n    \u003ca href=\"https://www.astil.dev/project/hata/docs/hata\"\u003eTechnical documentation\u003c/a\u003e |\n    \u003ca href=\"https://github.com/HuyaneMatsu/hata\"\u003eSource\u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1\u003e\u003c/h1\u003e\n\u003cbr\u003e\n\u003cp align=\"center\"\u003e\n    New hata versions use\n    \u003ca href=\"https://github.com/discord/discord-api-docs/discussions/4510\"\u003e\n        Discord API V10\n    \u003c/a\u003e\n    .\n\u003c/p\u003e\n\n\u003ch1\u003e\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003e\n    About\n\u003c/h3\u003e\n\n\n\nHata is an *asynchronous* [Discord API](https://discord.com/developers/docs/intro) wrapper built on top of scarletio.\nIt is designed to be easy to use, with also providing rich API offering everything what an advanced developer might\nneed.\n\nNamed after [Hata no Kokoro](https://en.touhouwiki.net/wiki/Hata_no_Kokoro) from Touhou Project.\n\n\u003ch1\u003e\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003e\n    Why hata?\n\u003c/h3\u003e\n\n- Multiple simultaneous clients\n\n    Hata can run multiple clients from the same instance without sacrificing performance.\n\n- Performant\n    \n    Fast concurrent code based on async/await paradigm with cache control, PyPy support and much more!\n\n- Newest API features\n    \n    Whatever Discord decides to release/update/break Hata will support it natively in no time!\n\n- 100% Python\n\n    Built in Python! Easy to code, easy to read, easy to maintain.\n\n\u003ch1\u003e\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003e\n    Usage\n\u003c/h3\u003e\n\nSimple example implementing a `ping` command.\n\n```py\nfrom hata import Client, Guild, wait_for_interruption\n\nGUILD = Guild.precreate(guild_id)\n\nSeija = Client('TOKEN', extensions = ['slash'])\n\n@Seija.events\nasync def ready(client):\n    print(f'{client:f} logged in.')\n\n@Seija.interactions(guild = GUILD)\nasync def ping():\n    \"\"\"ping-pong\"\"\"\n    return 'pong'\n\nSeija.start()\n\nwait_for_interruption()\n```\n\n\u003ch1\u003e\u003c/h1\u003e\n\n*Hata leaves the main thread free, `client.start()` blocks it only till the client logs in (or fails it), although you\ncan still use the `start_clients()` function, what as it says, starts up all the non-running clients parallelly.*\n\n*Sometimes leaving the main thread might cause problems when trying to shut down the bot(s). At this case, you might\nwant to use `wait_for_interruption()`, which disconnects the clients gracefully and closes the event loop on keyboard\ninterrupt.*\n\n\u003ch1\u003e\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003e\n    Installation\n\u003c/h3\u003e\n\nTo install Hata simply do\n\n```shell\n# Linux/OS X\n$ python3 -m pip install hata\n\n# Windows\n$ python -m pip install hata\n\n# Voice Support\n$ python -m pip install hata[voice]\n```\nAnd you are good to go! Hata has native pypy support as well if you need some more speed!\n\n\u003ch1\u003e\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003e\n    Dependencies\n\u003c/h3\u003e\n\n#### Requirements\n\n- Python \u003e= 3.6\n- [chardet](https://pypi.python.org/pypi/chardet) / [cchardet](https://pypi.org/project/cchardet/)\n\n#### Optional\n\n- [dateutil](https://pypi.org/project/python-dateutil/)\n- [PyNaCl](https://pypi.org/project/PyNaCl/) (for voice support)\n\n\u003ch1\u003e\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003e\n    Get in touch\n\u003c/h3\u003e\n\nIf you have issues, suggestions, want to contribute, or just want to hang out, join our discord server.\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://discord.gg/3cH2r5d\"\u003e\n        \u003cimg\n            alt=\"Invite\"\n            src=\"https://discordapp.com/api/v9/guilds/388267636661682178/widget.png?style=banner1\"\n        /\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ch1\u003e\u003c/h1\u003e\n\n\u003ch3 align=\"center\"\u003e\n    Acknowledgements\n\u003c/h3\u003e\n\nShout-Out to our brave testers who are helping the most to improve Hata!\n\n- [`Koish`](https://github.com/UnconsciousPebble) \\[Feature requests\\]\n- [`BrainDead`](https://github.com/albertopoljak) \\[Documentation improvements\\]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHuyaneMatsu%2Fhata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FHuyaneMatsu%2Fhata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FHuyaneMatsu%2Fhata/lists"}