Update formatting
This commit is contained in:
@ -67,4 +67,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|||||||
- `/remind resume` now has a list of all reminders instead of needing an ID.
|
- `/remind resume` now has a list of all reminders instead of needing an ID.
|
||||||
- `/remind remove` now has a list of all reminders instead of needing an ID.
|
- `/remind remove` now has a list of all reminders instead of needing an ID.
|
||||||
- `/remind list` now has a list of all reminders instead of needing an ID.
|
- `/remind list` now has a list of all reminders instead of needing an ID.
|
||||||
- !remind is now /remind. You need to reinvite the bot with the `applications.commands` scope for this to work. It will also take up to an hour for the slash command to be registered.
|
- !remind is now /remind. You need to reinvite the bot with the `applications.commands` scope for this to work. It will
|
||||||
|
also take up to an hour for the slash command to be registered.
|
||||||
|
@ -1,21 +1,21 @@
|
|||||||
# How to contribute to discord-reminder-bot
|
# How to contribute to discord-reminder-bot
|
||||||
|
|
||||||
- [Star the project](https://github.com/TheLovinator1/discord-reminder-bot/stargazers)
|
- [Star the project](https://github.com/TheLovinator1/discord-reminder-bot/stargazers)
|
||||||
- This is the easiest. Star the project and make me happy.
|
- This is the easiest. Star the project and make me happy.
|
||||||
- [Report bugs](https://github.com/TheLovinator1/discord-reminder-bot/issues/new)
|
- [Report bugs](https://github.com/TheLovinator1/discord-reminder-bot/issues/new)
|
||||||
- Make sure that you are using the latest version.
|
- Make sure that you are using the latest version.
|
||||||
- Collect all the information you can about the bug.
|
- Collect all the information you can about the bug.
|
||||||
- What did you do?
|
- What did you do?
|
||||||
- Error message and traceback (if any).
|
- Error message and traceback (if any).
|
||||||
- Operating system, Platform, and Version.
|
- Operating system, Platform, and Version.
|
||||||
- Python version, you can use `python --version` to get the version.
|
- Python version, you can use `python --version` to get the version.
|
||||||
- Are you using Docker?
|
- Are you using Docker?
|
||||||
- [Suggest enhancements](https://github.com/TheLovinator1/discord-reminder-bot/issues/new)
|
- [Suggest enhancements](https://github.com/TheLovinator1/discord-reminder-bot/issues/new)
|
||||||
- Try to describe what you want to see added.
|
- Try to describe what you want to see added.
|
||||||
- I can't promise that I will add it, but I will try my best.
|
- I can't promise that I will add it, but I will try my best.
|
||||||
- [Submit Pull Requests](https://github.com/TheLovinator1/discord-reminder-bot/pulls)
|
- [Submit Pull Requests](https://github.com/TheLovinator1/discord-reminder-bot/pulls)
|
||||||
- The only demand I have is that the code works, it doesn't have to be perfect or efficient.
|
- The only demand I have is that the code works, it doesn't have to be perfect or efficient.
|
||||||
- And if it doesn't work, I will try to fix it :)
|
- And if it doesn't work, I will try to fix it :)
|
||||||
|
|
||||||
## Contact
|
## Contact
|
||||||
|
|
||||||
|
67
README.md
67
README.md
@ -13,7 +13,8 @@ Type `/remind` in a Discord server where this bot exists to get a list of slash
|
|||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
You have two choices, [install directly on your computer](#Install-directly-on-your-computer) or using [Docker](https://hub.docker.com/r/thelovinator/discord-reminder-bot).
|
You have two choices, [install directly on your computer](#Install-directly-on-your-computer) or
|
||||||
|
using [Docker](https://hub.docker.com/r/thelovinator/discord-reminder-bot).
|
||||||
|
|
||||||
### Creating a Discord bot token
|
### Creating a Discord bot token
|
||||||
|
|
||||||
@ -22,34 +23,38 @@ You have two choices, [install directly on your computer](#Install-directly-on-y
|
|||||||
- You can change Icon and Username here.
|
- You can change Icon and Username here.
|
||||||
- Copy the bot token and paste it into the `BOT_TOKEN` environment variable.
|
- Copy the bot token and paste it into the `BOT_TOKEN` environment variable.
|
||||||
- Go to the OAuth2 page -> URL Generator
|
- Go to the OAuth2 page -> URL Generator
|
||||||
- Select the `bot` and `applications.commands` scope.
|
- Select the `bot` and `applications.commands` scope.
|
||||||
- Select the bot permissions that you want the bot to have. Select `Administrator`. (TODO: Add a list of permissions that are needed)
|
- Select the bot permissions that you want the bot to have. Select `Administrator`. (TODO: Add a list of permissions
|
||||||
- Copy the generated URL and open it in your browser. You can now invite the bot to your server.
|
that are needed)
|
||||||
|
- Copy the generated URL and open it in your browser. You can now invite the bot to your server.
|
||||||
|
|
||||||
### Install directly on your computer
|
### Install directly on your computer
|
||||||
|
|
||||||
- Install latest version of needed software:
|
- Install the latest version of needed software:
|
||||||
- [Python](https://www.python.org/)
|
- [Python](https://www.python.org/)
|
||||||
- You should use the latest version.
|
- You should use the latest version.
|
||||||
- You want to add Python to your PATH.
|
- You want to add Python to your PATH.
|
||||||
- [Poetry](https://python-poetry.org/docs/master/#installation)
|
- [Poetry](https://python-poetry.org/docs/master/#installation)
|
||||||
- Windows: You have to add `%appdata%\Python\Scripts` to your PATH for Poetry to work.
|
- Windows: You have to add `%appdata%\Python\Scripts` to your PATH for Poetry to work.
|
||||||
- Download project from GitHub with git or download the [ZIP](https://github.com/TheLovinator1/discord-reminder-bot/archive/refs/heads/master.zip).
|
- Download project from GitHub with Git or download
|
||||||
- If you want to update the bot, you can run `git pull` in the project folder or download the ZIP again.
|
the [ZIP](https://github.com/TheLovinator1/discord-reminder-bot/archive/refs/heads/master.zip).
|
||||||
|
- If you want to update the bot, you can run `git pull` in the project folder or download the ZIP again.
|
||||||
- Rename .env.example to .env and open it in a text editor (e.g., VSCode, Notepad++, Notepad).
|
- Rename .env.example to .env and open it in a text editor (e.g., VSCode, Notepad++, Notepad).
|
||||||
- If you can't see the file extension:
|
- If you can't see the file extension:
|
||||||
- Windows 10: Click the View Tab in File Explorer and click the box next to File name extensions.
|
- Windows 10: Click the View Tab in File Explorer and click the box next to File name extensions.
|
||||||
- Windows 11: Click View -> Show -> File name extensions.
|
- Windows 11: Click View -> Show -> File name extensions.
|
||||||
- Open a terminal in the repository folder.
|
- Open a terminal in the repository folder.
|
||||||
- Windows 10: <kbd>Shift</kbd> + <kbd>right-click</kbd> in the folder and select `Open PowerShell window here`
|
- Windows 10: <kbd>Shift</kbd> + <kbd>right-click</kbd> in the folder and select `Open PowerShell window here`
|
||||||
- Windows 11: <kbd>Shift</kbd> + <kbd>right-click</kbd> in the folder and Show more options and `Open PowerShell window here`
|
- Windows 11: <kbd>Shift</kbd> + <kbd>right-click</kbd> in the folder and Show more options
|
||||||
|
and `Open PowerShell window here`
|
||||||
- Install requirements:
|
- Install requirements:
|
||||||
- Type `poetry install` into the PowerShell window. Make sure you are
|
- Type `poetry install` into the PowerShell window. Make sure you are
|
||||||
in the repository folder with the [pyproject.toml](pyproject.toml) file.
|
in the repository folder with the [pyproject.toml](pyproject.toml) file.
|
||||||
- You may have to restart your terminal if it can't find the `poetry` command. Also double check that it's in your PATH.
|
- You may have to restart your terminal if it can't find the `poetry` command. Also double check it is in
|
||||||
|
your PATH.
|
||||||
- Start the bot:
|
- Start the bot:
|
||||||
- Type `poetry run bot` into the PowerShell window.
|
- Type `poetry run bot` into the PowerShell window.
|
||||||
- You can stop the bot with <kbd>Ctrl</kbd> + <kbd>c</kbd>.
|
- You can stop the bot with <kbd>Ctrl</kbd> + <kbd>c</kbd>.
|
||||||
|
|
||||||
Note: You will need to run `poetry install` again if poetry.lock has been modified.
|
Note: You will need to run `poetry install` again if poetry.lock has been modified.
|
||||||
|
|
||||||
@ -60,22 +65,22 @@ Note: It can take up to one hour for the slash commands to be visible in the Dis
|
|||||||
Docker Hub: [thelovinator/discord-reminder-bot](https://hub.docker.com/r/thelovinator/discord-reminder-bot)
|
Docker Hub: [thelovinator/discord-reminder-bot](https://hub.docker.com/r/thelovinator/discord-reminder-bot)
|
||||||
|
|
||||||
- Rename .env.example to .env and open it in a text editor (e.g., VSCode, Notepad++, Notepad).
|
- Rename .env.example to .env and open it in a text editor (e.g., VSCode, Notepad++, Notepad).
|
||||||
- If you can't see the file extension:
|
- If you can't see the file extension:
|
||||||
- Windows 10: Click the View Tab in File Explorer and click the box next to File name extensions.
|
- Windows 10: Click the View Tab in File Explorer and click the box next to File name extensions.
|
||||||
- Windows 11: Click View -> Show -> File name extensions.
|
- Windows 11: Click View -> Show -> File name extensions.
|
||||||
- Open a terminal in the extras folder.
|
- Open a terminal in the extras folder.
|
||||||
- Windows 10: <kbd>Shift</kbd> + <kbd>right-click</kbd> in the folder and select `Open PowerShell window here`
|
- Windows 10: <kbd>Shift</kbd> + <kbd>right-click</kbd> in the folder and select `Open PowerShell window here`
|
||||||
- Windows 11: <kbd>Shift</kbd> + <kbd>right-click</kbd> in the folder and Show more options and `Open PowerShell window here`
|
- Windows 11: <kbd>Shift</kbd> + <kbd>right-click</kbd> in the folder and Show more options
|
||||||
|
and `Open PowerShell window here`
|
||||||
- Run the Docker Compose file:
|
- Run the Docker Compose file:
|
||||||
- `docker-compose up`
|
- `docker-compose up`
|
||||||
- You can stop the bot with <kbd>Ctrl</kbd> + <kbd>c</kbd>.
|
- You can stop the bot with <kbd>Ctrl</kbd> + <kbd>c</kbd>.
|
||||||
- If you want to run the bot in the background, you can run `docker-compose up -d`.
|
- If you want to run the bot in the background, you can run `docker-compose up -d`.
|
||||||
|
|
||||||
## Help
|
## Help
|
||||||
|
|
||||||
- Email: tlovinator@gmail.com
|
- Email: tlovinator@gmail.com
|
||||||
- Discord: TheLovinator#9276
|
- Discord: TheLovinator#9276
|
||||||
- Steam: [steamcommunity.com/id/TheLovinator/](https://steamcommunity.com/id/TheLovinator/)
|
|
||||||
- Send an issue: [discord-reminder-bot/issues](https://github.com/TheLovinator1/discord-reminder-bot/issues)
|
- Send an issue: [discord-reminder-bot/issues](https://github.com/TheLovinator1/discord-reminder-bot/issues)
|
||||||
- GitHub Discussions:
|
- GitHub Discussions:
|
||||||
[discord-reminder-bot/discussions](https://github.com/TheLovinator1/discord-reminder-bot/discussions)
|
[discord-reminder-bot/discussions](https://github.com/TheLovinator1/discord-reminder-bot/discussions)
|
||||||
|
@ -59,7 +59,7 @@ def calc_countdown(job) -> str:
|
|||||||
|
|
||||||
# TODO: Explain this.
|
# TODO: Explain this.
|
||||||
return ", ".join(
|
return ", ".join(
|
||||||
f"{x} {y}{'s'*(x!=1)}"
|
f"{x} {y}{'s' * (x != 1)}"
|
||||||
for x, y in (
|
for x, y in (
|
||||||
(days, "day"),
|
(days, "day"),
|
||||||
(hours, "hour"),
|
(hours, "hour"),
|
||||||
@ -466,10 +466,10 @@ async def remind_resume(ctx: SlashContext):
|
|||||||
],
|
],
|
||||||
)
|
)
|
||||||
async def remind_add(
|
async def remind_add(
|
||||||
ctx: SlashContext,
|
ctx: SlashContext,
|
||||||
message_date: str,
|
message_date: str,
|
||||||
message_reason: str,
|
message_reason: str,
|
||||||
different_channel: discord.TextChannel = None,
|
different_channel: discord.TextChannel = None,
|
||||||
):
|
):
|
||||||
"""Add a new reminder. You can add a date and message.
|
"""Add a new reminder. You can add a date and message.
|
||||||
|
|
||||||
@ -605,21 +605,21 @@ async def remind_add(
|
|||||||
],
|
],
|
||||||
)
|
)
|
||||||
async def remind_cron(
|
async def remind_cron(
|
||||||
ctx: SlashContext,
|
ctx: SlashContext,
|
||||||
message_reason: str,
|
message_reason: str,
|
||||||
year: int = None,
|
year: int = None,
|
||||||
month: int = None,
|
month: int = None,
|
||||||
day: int = None,
|
day: int = None,
|
||||||
week: int = None,
|
week: int = None,
|
||||||
day_of_week: str = None,
|
day_of_week: str = None,
|
||||||
hour: int = None,
|
hour: int = None,
|
||||||
minute: int = None,
|
minute: int = None,
|
||||||
second: int = None,
|
second: int = None,
|
||||||
start_date: str = None,
|
start_date: str = None,
|
||||||
end_date: str = None,
|
end_date: str = None,
|
||||||
timezone: str = None,
|
timezone: str = None,
|
||||||
jitter: int = None,
|
jitter: int = None,
|
||||||
different_channel: discord.TextChannel = None,
|
different_channel: discord.TextChannel = None,
|
||||||
):
|
):
|
||||||
"""Create new cron job. Works like UNIX cron.
|
"""Create new cron job. Works like UNIX cron.
|
||||||
|
|
||||||
@ -755,18 +755,18 @@ async def remind_cron(
|
|||||||
],
|
],
|
||||||
)
|
)
|
||||||
async def remind_interval(
|
async def remind_interval(
|
||||||
ctx: SlashContext,
|
ctx: SlashContext,
|
||||||
message_reason: str,
|
message_reason: str,
|
||||||
weeks: int = 0,
|
weeks: int = 0,
|
||||||
days: int = 0,
|
days: int = 0,
|
||||||
hours: int = 0,
|
hours: int = 0,
|
||||||
minutes: int = 0,
|
minutes: int = 0,
|
||||||
seconds: int = 0,
|
seconds: int = 0,
|
||||||
start_date: str = None,
|
start_date: str = None,
|
||||||
end_date: str = None,
|
end_date: str = None,
|
||||||
timezone: str = None,
|
timezone: str = None,
|
||||||
jitter: int = None,
|
jitter: int = None,
|
||||||
different_channel: discord.TextChannel = None,
|
different_channel: discord.TextChannel = None,
|
||||||
):
|
):
|
||||||
"""Create new reminder that triggers based on a interval.
|
"""Create new reminder that triggers based on a interval.
|
||||||
|
|
||||||
|
@ -38,10 +38,3 @@ types-pytz = "^2022.1.2"
|
|||||||
[build-system]
|
[build-system]
|
||||||
requires = ["poetry-core>=1.0.0"]
|
requires = ["poetry-core>=1.0.0"]
|
||||||
build-backend = "poetry.core.masonry.api"
|
build-backend = "poetry.core.masonry.api"
|
||||||
|
|
||||||
[tool.black]
|
|
||||||
line-length = 120
|
|
||||||
|
|
||||||
[tool.isort]
|
|
||||||
profile = "black"
|
|
||||||
line_length = 120
|
|
||||||
|
Reference in New Issue
Block a user