Skip to content

Commit e4299ef

Browse files
authored
🏷️ Template v6.0.0 (#89)
1 parent 6231b45 commit e4299ef

18 files changed

+513
-665
lines changed

.env.example

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
TOKEN=YOUR_BOT_TOKEN_HERE

CONTRIBUTING.md

+21-13
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,45 @@
11
# Contributing Guidelines
2+
23
Your input is amazing! Making contributing to this project as easy and transparent as possible is one of the most important side, this includes:
34

4-
- Reporting a bug
5-
- Discussing the current state of the code
6-
- Submitting a fix
7-
- Proposing new features
8-
- Becoming a maintainer
5+
- Reporting a bug
6+
- Discussing the current state of the code
7+
- Submitting a fix
8+
- Proposing new features
9+
- Becoming a maintainer
910

1011
## Wanted changes
11-
- New features
12-
- Better documentation
13-
- Fixing of spelling and grammatical issues
12+
13+
- New features
14+
- Better documentation
15+
- Fixing of spelling and grammatical issues
1416

1517
## Unwanted changes
16-
- Whitespaces and punctuation changes
17-
- Word changes using synonyms
18-
- Entire rewrites of the project, or parts of the project - unless approved first by a maintainer
18+
19+
- Whitespaces and punctuation changes
20+
- Word changes using synonyms
21+
- Entire rewrites of the project, or parts of the project - unless approved first by a maintainer
1922

2023
## All code changes happen through pull requests
24+
2125
Pull requests are the best way to propose changes to the codebase. We actively welcome your pull requests:
2226

2327
1. Fork the repo and create your branch from `main`.
2428
2. Keep consistency with the current state of the codebase, this includes but is not limited to naming convention, Discord embeds, etc.
25-
3. Format the code of the files you've edited with the **black** formatter.
26-
4. Issue that pull request!
29+
3. Format the code of the **Python** files you've edited with the **black** formatter and **all others** with the **Prettier** formatter.
30+
4. Sort the imports with `isort`
31+
5. Issue that pull request!
2732

2833
## Commit messages guidelines
34+
2935
This project uses [`Conventional Commits 1.0.0`](https://conventionalcommits.org/en/v1.0.0/) hence your commit messages **must** follow the same convention or your contributions will be ignored, refused or assigned to another user or maintainer.
3036

3137
It would be more than welcome to keep your contributions as a single commit rather than, for examples, 20 `"fix: Stuff"` commits in-between. You may use multiple commmits if you believe the changes made in these commmits have nothing, or close to nothing, in common - feel free to ask a maintainer on whether or not it should be a single commit or not.
3238

3339
## Create a GitHub [Issue](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/issues) and **then** a pull request
40+
3441
Start contributing by first [opening a new issue](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/issues/new/choose). Once that is done, you can create a pull request for the issue.
3542

3643
## License
44+
3745
Your submissions are understood to be under the same [Apache License 2.0](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/blob/main/LICENSE.md) that covers the project.

README.md

+32-26
Original file line numberDiff line numberDiff line change
@@ -14,24 +14,24 @@ This repository is a template that everyone can use for the start of their disco
1414

1515
When I first started creating my discord bot it took me a while to get everything setup and working with cogs and more.
1616
I would've been happy if there were any template existing. However, there wasn't any existing template. That's why I
17-
decided to create my own template to let <b>you</b> guys create your discord bot easily.
17+
decided to create my own template to let **you** guys create your discord bot easily.
1818

1919
Please note that this template is not supposed to be the best template, but a good template to start learning how
2020
discord.py works and to make your own bot easily.
2121

2222
If you plan to use this template to make your own template or bot, you **have to**:
2323

24-
- Keep the credits, and a link to this repository in all the files that contains my code
25-
- Keep the same license for unchanged code
24+
- Keep the credits, and a link to this repository in all the files that contains my code
25+
- Keep the same license for unchanged code
2626

2727
See [the license file](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/blob/master/LICENSE.md) for more
2828
information, I reserve the right to take down any repository that does not meet these requirements.
2929

3030
## Support
3131

3232
Before requesting support, you should know that this template requires you to have at least a **basic knowledge** of
33-
Python and the library is made for advanced users. Do not use this template if you don't know the
34-
basics. [Here's](https://pythondiscord.com/pages/resources) a link for resources to learn python.
33+
Python and the library is made for **advanced users**. Do not use this template if you don't know the
34+
basics or some advanced topics such as OOP or async. [Here's](https://pythondiscord.com/pages/resources) a link for resources to learn python.
3535

3636
If you need some help for something, do not hesitate to join my discord server [here](https://discord.gg/mTBrXyWxAF).
3737

@@ -62,32 +62,38 @@ repository based on this template.
6262

6363
Alternatively you can do the following:
6464

65-
* Clone/Download the repository
66-
* To clone it and get the updates you can definitely use the command
67-
`git clone`
68-
* Create a discord bot [here](https://discord.com/developers/applications)
69-
* Get your bot token
70-
* Invite your bot on servers using the following invite:
71-
https://discord.com/oauth2/authorize?&client_id=YOUR_APPLICATION_ID_HERE&scope=bot+applications.commands&permissions=PERMISSIONS (
72-
Replace `YOUR_APPLICATION_ID_HERE` with the application ID and replace `PERMISSIONS` with the required permissions
73-
your bot needs that it can be get at the bottom of a this
74-
page https://discord.com/developers/applications/YOUR_APPLICATION_ID_HERE/bot)
65+
- Clone/Download the repository
66+
- To clone it and get the updates you can definitely use the command
67+
`git clone`
68+
- Create a discord bot [here](https://discord.com/developers/applications)
69+
- Get your bot token
70+
- Invite your bot on servers using the following invite:
71+
https://discord.com/oauth2/authorize?&client_id=YOUR_APPLICATION_ID_HERE&scope=bot+applications.commands&permissions=PERMISSIONS (
72+
Replace `YOUR_APPLICATION_ID_HERE` with the application ID and replace `PERMISSIONS` with the required permissions
73+
your bot needs that it can be get at the bottom of a this
74+
page https://discord.com/developers/applications/YOUR_APPLICATION_ID_HERE/bot)
7575

7676
## How to set up
7777

78-
To set up the bot I made it as simple as possible. I now created a [config.json](config.json) file where you can put the
78+
To set up the bot it was made as simple as possible.
79+
80+
### `config.json` file
81+
82+
There is [`config.json`](config.json) file where you can put the
7983
needed things to edit.
8084

8185
Here is an explanation of what everything is:
8286

83-
| Variable | What it is |
84-
| ------------------------- | ----------------------------------------------------------------------|
85-
| YOUR_BOT_PREFIX_HERE | The prefix you want to use for normal commands |
86-
| YOUR_BOT_TOKEN_HERE | The token of your bot |
87-
| YOUR_BOT_PERMISSIONS_HERE | The permissions integer your bot needs when it gets invited |
88-
| YOUR_APPLICATION_ID_HERE | The application ID of your bot |
89-
| OWNERS | The user ID of all the bot owners |
87+
| Variable | What it is |
88+
| ------------------------- | ---------------------------------------------- |
89+
| YOUR_BOT_PREFIX_HERE | The prefix you want to use for normal commands |
90+
| YOUR_BOT_INVITE_LINK_HERE | The link to invite the bot |
91+
92+
### `.env` file
93+
94+
To set up the token you will have to either make use of the [`.env.example`](.env.example) file, either copy or rename it to `.env` and replace `YOUR_BOT_TOKEN_HERE` with your bot's token.
9095

96+
Alternatively you can simply create an environment variable named `TOKEN`.
9197

9298
## How to start
9399

@@ -113,8 +119,8 @@ python bot.py
113119

114120
If you have any issues or questions of how to code a specific command, you can:
115121

116-
* Join my discord server [here](https://discord.gg/mTBrXyWxAF)
117-
* Post them [here](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/issues)
122+
- Join my discord server [here](https://discord.gg/mTBrXyWxAF)
123+
- Post them [here](https://github.com/kkrypt0nn/Python-Discord-Bot-Template/issues)
118124

119125
Me or other people will take their time to answer and help you.
120126

@@ -125,7 +131,7 @@ the [tags on this repository](https://github.com/kkrypt0nn/Python-Discord-Bot-Te
125131

126132
## Built With
127133

128-
* [Python 3.9.12](https://www.python.org/)
134+
- [Python 3.11.5](https://www.python.org/)
129135

130136
## License
131137

TODO.md

-15
This file was deleted.

0 commit comments

Comments
 (0)