{"id":18522094,"url":"https://github.com/sigmanificient/embed-templator","last_synced_at":"2026-03-10T09:39:29.195Z","repository":{"id":36979900,"uuid":"399233753","full_name":"Sigmanificient/Embed-Templator","owner":"Sigmanificient","description":"A Python Template manager for your discord bot to keep your embeds simple consistent","archived":false,"fork":false,"pushed_at":"2024-04-15T03:27:55.000Z","size":135,"stargazers_count":4,"open_issues_count":1,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-04-20T13:56:45.184Z","etag":null,"topics":["discord","discord-embed","discord-embed-builder","discordpy","pypi","pypi-package","python","python-pakage","python3","python38","python39"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/embed-templator/","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/Sigmanificient.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"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":"2021-08-23T20:03:35.000Z","updated_at":"2024-05-22T20:31:09.753Z","dependencies_parsed_at":"2024-05-22T20:31:06.131Z","dependency_job_id":null,"html_url":"https://github.com/Sigmanificient/Embed-Templator","commit_stats":{"total_commits":117,"total_committers":3,"mean_commits":39.0,"dds":"0.23076923076923073","last_synced_commit":"4010142f75cc4455073b608cfb3d11809ec7f266"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sigmanificient%2FEmbed-Templator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sigmanificient%2FEmbed-Templator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sigmanificient%2FEmbed-Templator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sigmanificient%2FEmbed-Templator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sigmanificient","download_url":"https://codeload.github.com/Sigmanificient/Embed-Templator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248012919,"owners_count":21033266,"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":["discord","discord-embed","discord-embed-builder","discordpy","pypi","pypi-package","python","python-pakage","python3","python38","python39"],"created_at":"2024-11-06T17:29:02.018Z","updated_at":"2026-03-10T09:39:29.150Z","avatar_url":"https://github.com/Sigmanificient.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Embed Templator\n\n![PyPI - Downloads](https://img.shields.io/pypi/dm/Embed-Templator)\n[![PyPI - Downloads](https://img.shields.io/badge/dynamic/json?label=downloads\u0026query=%24.total_downloads\u0026url=https%3A%2F%2Fapi.pepy.tech%2Fapi%2Fprojects%2FEmbed-Templator)](https://pypi.org/project/Embed-Templator/)\n![PyPI](https://img.shields.io/pypi/v/Embed-Templator)\n![PyPI - Format](https://img.shields.io/pypi/format/Embed-Templator)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/Embed-Templator)\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/Sigmanificient/Embed-Templator)\n![GitHub repo size](https://img.shields.io/github/repo-size/Sigmanificient/Embed-Templator)\n![GitHub last commit](https://img.shields.io/github/last-commit/Sigmanificient/Embed-Templator)\n\n*A Python Template manager for your discord bot to keep your embeds simple \u0026 consistent*\n\n# Installation\n\nUse The following command to install Embed-Templator into your python environment:\n```bash\npip install Embed-Templator\n```\n\n\u003cdetails\u003e\n\t\u003csummary\u003e\n\t\t\u003ci\u003edidn't works?\u003c/i\u003e\n\t\u003c/summary\u003e\n\nDepending on your python installation, you might need to use one of the following.\n\n*pip isn't in the path but python is*\n```sh\npython -m pip install embed-templator\n```\n\n*python isn't in the path*\n```sh\npath/to/python.exe -m pip install embed-templator\n```\n\n*Using multiple python versions*\n```sh\npy -m pip install embed-templator\n```\n\u003c/details\u003e\n\n# Usage\n\n### Simplest\n\nThe simplest way to use the Embed templator in your project is the following:\n```py\nfrom embed_templator import Embed\n\n# Loading your client instance withing the embed templator.\nEmbed.load(client)\n\n\n@client.command()\nasync def ping(ctx):\n    # Use it like a regular Embed.\n    await ctx.send(embed=Embed(description='pong!'))\n```\n\n### Context Embeds\n\nHowever, the embed templator can have more advanced usage, and use context embeds.\n```py\nfrom embed_templator import Embed\n\nclient = ...\n\n# Note that auto_author requires the ctx to be passed at embeds init.\nEmbed.load(client, auto_author=True)\n\n\n@client.command()\nasync def ping(ctx):\n    # Use it like a regular Embed.\n    await ctx.send(embed=Embed(ctx)(description='pong!'))\n```\n\n### Cogs\nIf you are using a cog based system, don't forget to init the embed in your cogs with the following:\n\n```py\nclass MyBeautifulCog(commands.Cog):\n\n    def __init__(self, client):\n        self.client = client\n        \n        Embed.load(self.client)\n```\n\nThen you'll be able to use it like the previous examples:\n```py\n    @commands.command()\n    async def my(self, ctx):\n\n        await ctx.send(\n            embed=Embed(ctx)(description=\"Cabbage\")\n        )\n```\n\n### Advanced Usage\n\nIf you want an advanced embed configuration, you can create a custom embed class\nthat will inherit the embed templator.\n\n```py\nfrom __future__ import annotations\nimport embed_templator\n\n\nclass Embed(embed_templator.Embed):\n    \n    def setup(self) -\u003e Embed:\n        return self.set_footer(\n            text=f\"{self.ctx.command} | more info @ {self.ctx.prefix}help\"\n        )\n```\n\n\u003chr\u003e\nYou can also use the `update` method for last changes in the embed, better it will be sent.\n\n| :exclamation: | *This example uses a custom ctx that have time tracking !* |\n| ------------- | :--------------------------------------------------------- |\n\n```py\nfrom __future__ import annotations\nimport embed_templator\n\n\nclass Embed(embed_templator.Embed):\n\n    def setup(self) -\u003e Embed:\n        return self.set_author(\n            name=f\"Requested by {self.ctx.author} 🚀\",\n            icon_url=self.ctx.author.avatar_url\n        )\n\n    def update(self) -\u003e Embed:\n        self.set_footer(\n            icon_url=self.client.user.avatar_url,\n            text='   '.join(\n                (\n                    f\"⚙️ {self.ctx.time.elapsed()}\",\n                    f\"⏳ {self.client.latency}\",\n                    f\"🔑 {self.ctx.prefix}help\",\n                )\n            )\n        )\n\n        return self\n```\n\n\u003chr\u003e\n\n***Thanks for using Embed-Templator!***\n\n## License\n\n`© 2020 copyright Edhyjox`\n\nThis repository is licensed under the MIT License. See LICENSE for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsigmanificient%2Fembed-templator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsigmanificient%2Fembed-templator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsigmanificient%2Fembed-templator/lists"}