| Name | tdcord JSON |
| Version |
0.1.3
JSON |
| download |
| home_page | |
| Summary | An easy-to-use extension for Discord.py and Pycord |
| upload_time | 2023-12-21 00:37:38 |
| maintainer | |
| docs_url | None |
| author | tibue99 |
| requires_python | >=3.9 |
| license | MIT |
| keywords |
discord
pycord
py-cord
discord.py
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://github.com/tdius9/tdcord)
[](https://discord.gg/zfvbjTtdv6)
[](https://pypi.org/project/tdcord/)
[](https://github.com/tdius9/tdcord/blob/main/LICENSE)
[](https://github.com/tdius9/tdcord)
An easy-to-use extension for [Discord.py](https://github.com/Rapptz/discord.py)
and [Pycord](https://github.com/Pycord-Development/pycord) with some utility functions.
## Features
### ✏️ Reduce boilerplate code
- Easy cog management
- Embed templates
- Datetime and file utilities
- Wrapper for [aiosqlite](https://github.com/omnilib/aiosqlite)
### ✨ Error handling
- Automatic error handling for slash commands
- Error webhook reports
- Custom logging
### ⚙️ Extensions
- **Help command** - Automatically generate a help command for your bot
- **Status changer** - Change the bot's status in an interval
- **Blacklist** - Block users from using your bot
## Installing
Python 3.9 or higher is required.
```
pip install tdcord
```
You can also install the latest version from GitHub. Note that this version may be unstable
and requires [git](https://git-scm.com/downloads) to be installed.
```
pip install git+https://github.com/tdius9/tdcord
```
If you need the latest version in your `requirements.txt` file, you can add this line:
```
tdcord @ git+https://github.com/tdius/tdcord
```
## Useful Links
- [Documentation](https://tdcord.readthedocs.io/) | [Getting started](https://tdcord.readthedocs.io/en/latest/pages/getting_started.html)
- [Pycord](https://docs.pycord.dev/) | [Discord.py](https://discordpy.readthedocs.io/en/stable/)
- [PyPi](https://pypi.org/project/tdcord/)
## Examples
- For more examples, see the [example repository](https://github.com/tdius9/tdcord_template)
or the [sample code](https://tdcord.readthedocs.io/en/latest/examples/examples.html).
- **Note:** It's recommended to [load the token](https://guide.pycord.dev/getting-started/creating-your-first-bot#protecting-tokens) from a `.env` file instead of hardcoding it.
TdCord can automatically load the token if a `TOKEN` variable is present in the `.env` file.
### Pycord
```py
import tdcord
import discord
bot = tdcord.Bot(
intents=discord.Intents.default()
)
if __name__ == "__main__":
bot.load_cogs("cogs") # Load all cogs in the "cogs" folder
bot.run("TOKEN")
```
### Discord.py
```py
import asyncio
import discord
import tdcord
class Bot(tdcord.Bot):
def __init__(self):
super().__init__(intents=discord.Intents.default())
async def setup_hook(self):
await super().setup_hook()
await self.tree.sync()
async def main():
async with Bot() as bot:
bot.add_help_command()
bot.load_cogs("cogs") # Load all cogs in the "cogs" folder
await bot.start("TOKEN")
if __name__ == "__main__":
asyncio.run(main())
```
## Contributing
I am always happy to receive contributions. Here is how to do it:
1. Fork this repository
2. Make changes
3. Create a pull request
You can also [create an issue](https://github.com/tdius9/tdcord/issues/new) if you find any bugs.
Raw data
{
"_id": null,
"home_page": "",
"name": "tdcord",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "discord,pycord,py-cord,discord.py",
"author": "tibue99",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/49/f2/f712b172bb6a7e813e53e2c0fc92ea5bf231d0f724202d5c72de9ee6c9a2/tdcord-0.1.3.tar.gz",
"platform": null,
"description": "[](https://github.com/tdius9/tdcord)\r\n\r\n[](https://discord.gg/zfvbjTtdv6)\r\n[](https://pypi.org/project/tdcord/)\r\n[](https://github.com/tdius9/tdcord/blob/main/LICENSE)\r\n[](https://github.com/tdius9/tdcord)\r\n\r\nAn easy-to-use extension for [Discord.py](https://github.com/Rapptz/discord.py)\r\nand [Pycord](https://github.com/Pycord-Development/pycord) with some utility functions.\r\n\r\n## Features\r\n\r\n### \u270f\ufe0f Reduce boilerplate code\r\n\r\n- Easy cog management\r\n- Embed templates\r\n- Datetime and file utilities\r\n- Wrapper for [aiosqlite](https://github.com/omnilib/aiosqlite)\r\n\r\n### \u2728 Error handling\r\n\r\n- Automatic error handling for slash commands\r\n- Error webhook reports\r\n- Custom logging\r\n\r\n### \u2699\ufe0f Extensions\r\n\r\n- **Help command** - Automatically generate a help command for your bot\r\n- **Status changer** - Change the bot's status in an interval\r\n- **Blacklist** - Block users from using your bot\r\n\r\n## Installing\r\n\r\nPython 3.9 or higher is required.\r\n\r\n```\r\npip install tdcord\r\n```\r\n\r\nYou can also install the latest version from GitHub. Note that this version may be unstable\r\nand requires [git](https://git-scm.com/downloads) to be installed.\r\n\r\n```\r\npip install git+https://github.com/tdius9/tdcord\r\n```\r\n\r\nIf you need the latest version in your `requirements.txt` file, you can add this line:\r\n\r\n```\r\ntdcord @ git+https://github.com/tdius/tdcord\r\n```\r\n\r\n## Useful Links\r\n\r\n- [Documentation](https://tdcord.readthedocs.io/) | [Getting started](https://tdcord.readthedocs.io/en/latest/pages/getting_started.html)\r\n- [Pycord](https://docs.pycord.dev/) | [Discord.py](https://discordpy.readthedocs.io/en/stable/)\r\n- [PyPi](https://pypi.org/project/tdcord/)\r\n\r\n## Examples\r\n\r\n- For more examples, see the [example repository](https://github.com/tdius9/tdcord_template)\r\n or the [sample code](https://tdcord.readthedocs.io/en/latest/examples/examples.html).\r\n- **Note:** It's recommended to [load the token](https://guide.pycord.dev/getting-started/creating-your-first-bot#protecting-tokens) from a `.env` file instead of hardcoding it.\r\n TdCord can automatically load the token if a `TOKEN` variable is present in the `.env` file.\r\n\r\n### Pycord\r\n\r\n```py\r\nimport tdcord\r\nimport discord\r\n\r\nbot = tdcord.Bot(\r\n intents=discord.Intents.default()\r\n)\r\n\r\nif __name__ == \"__main__\":\r\n bot.load_cogs(\"cogs\") # Load all cogs in the \"cogs\" folder\r\n bot.run(\"TOKEN\")\r\n```\r\n\r\n### Discord.py\r\n\r\n```py\r\nimport asyncio\r\nimport discord\r\nimport tdcord\r\n\r\n\r\nclass Bot(tdcord.Bot):\r\n def __init__(self):\r\n super().__init__(intents=discord.Intents.default())\r\n\r\n async def setup_hook(self):\r\n await super().setup_hook()\r\n await self.tree.sync()\r\n\r\n\r\nasync def main():\r\n async with Bot() as bot:\r\n bot.add_help_command()\r\n bot.load_cogs(\"cogs\") # Load all cogs in the \"cogs\" folder\r\n await bot.start(\"TOKEN\")\r\n\r\n\r\nif __name__ == \"__main__\":\r\n asyncio.run(main())\r\n```\r\n\r\n## Contributing\r\n\r\nI am always happy to receive contributions. Here is how to do it:\r\n\r\n1. Fork this repository\r\n2. Make changes\r\n3. Create a pull request\r\n\r\nYou can also [create an issue](https://github.com/tdius9/tdcord/issues/new) if you find any bugs.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "An easy-to-use extension for Discord.py and Pycord",
"version": "0.1.3",
"project_urls": {
"Documentation": "https://tdcord.readthedocs.io",
"GitHub": "https://github.com/tibue99/tdcord"
},
"split_keywords": [
"discord",
"pycord",
"py-cord",
"discord.py"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "996c3180cfe5974e9ef3fdfc9eb5a1aad10a8147f3bc3855efe0390d3e31447b",
"md5": "1d20d29a31b0d0cdc7656dba48167599",
"sha256": "33870bd943f2f12ea9b361590fb36b6f2c8ded71be04616c0881925dd04b4e1c"
},
"downloads": -1,
"filename": "tdcord-0.1.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1d20d29a31b0d0cdc7656dba48167599",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 47241,
"upload_time": "2023-12-21T00:37:36",
"upload_time_iso_8601": "2023-12-21T00:37:36.769116Z",
"url": "https://files.pythonhosted.org/packages/99/6c/3180cfe5974e9ef3fdfc9eb5a1aad10a8147f3bc3855efe0390d3e31447b/tdcord-0.1.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "49f2f712b172bb6a7e813e53e2c0fc92ea5bf231d0f724202d5c72de9ee6c9a2",
"md5": "26daab166adfb43cdb4079fbfdc883bd",
"sha256": "96b112b93a30e65f5c49008404be1eb792f680db749d0b159c362d5fb8bd0241"
},
"downloads": -1,
"filename": "tdcord-0.1.3.tar.gz",
"has_sig": false,
"md5_digest": "26daab166adfb43cdb4079fbfdc883bd",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 41731,
"upload_time": "2023-12-21T00:37:38",
"upload_time_iso_8601": "2023-12-21T00:37:38.426276Z",
"url": "https://files.pythonhosted.org/packages/49/f2/f712b172bb6a7e813e53e2c0fc92ea5bf231d0f724202d5c72de9ee6c9a2/tdcord-0.1.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-21 00:37:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tibue99",
"github_project": "tdcord",
"github_not_found": true,
"lcname": "tdcord"
}
