54 lines
1.5 KiB
Markdown
54 lines
1.5 KiB
Markdown
|
# Testing Guide: Grocery Receipt Tracker
|
||
|
|
|
||
|
|
This guide will help you set up and test the Grocery Receipt Tracker with Discord integration.
|
||
|
|
|
||
|
|
## Prerequisites
|
||
|
|
|
||
|
|
- Python 3.8 or higher
|
||
|
|
- Discord account
|
||
|
|
- Basic understanding of command line operations
|
||
|
|
|
||
|
|
## Step 1: Create a Discord Bot
|
||
|
|
|
||
|
|
1. Go to the [Discord Developer Portal](https://discord.com/developers/applications)
|
||
|
|
2. Click "New Application" and give it a name (e.g., "Grocery Receipt Tracker")
|
||
|
|
3. Navigate to the "Bot" section in the left sidebar
|
||
|
|
4. Click "Add Bot"
|
||
|
|
5. Under "Privileged Gateway Intents", enable:
|
||
|
|
- MESSAGE CONTENT INTENT
|
||
|
|
- SERVER MEMBERS INTENT
|
||
|
|
6. Click "Reset Token" and copy your bot token
|
||
|
|
7. Save the token securely (you'll need it for the application)
|
||
|
|
|
||
|
|
## Step 2: Add the Bot to Your Server
|
||
|
|
|
||
|
|
1. In the Developer Portal, go to "OAuth2" > "URL Generator"
|
||
|
|
2. Select these scopes:
|
||
|
|
- `bot`
|
||
|
|
- `applications.commands`
|
||
|
|
3. Under "Bot Permissions", select:
|
||
|
|
- `Send Messages`
|
||
|
|
- `Attach Files`
|
||
|
|
- `Read Message History`
|
||
|
|
4. Copy the generated URL and open it in your browser
|
||
|
|
5. Select the server where you want to add the bot
|
||
|
|
6. Click "Authorize"
|
||
|
|
|
||
|
|
## Step 3: Set Up the Project
|
||
|
|
|
||
|
|
1. Clone or download the project files
|
||
|
|
2. Create a virtual environment (recommended):
|
||
|
|
```bash
|
||
|
|
python -m venv venv
|
||
|
|
source venv/bin/activate # On Windows: venv\Scripts\activate
|
||
|
|
```
|
||
|
|
3. Install dependencies:
|
||
|
|
```bash
|
||
|
|
pip install -r requirements.txt
|
||
|
|
```
|
||
|
|
|
||
|
|
## Step 4: Configure Environment Variables
|
||
|
|
|
||
|
|
Create a `.env` file in the project root with your Discord bot token:
|
||
|
|
|