diff --git a/.DS_Store b/.DS_Store index 0448198..a9b1ab4 100644 Binary files a/.DS_Store and b/.DS_Store differ diff --git a/jokes-bot-v3.0/.DS_Store b/jokes_bot/.DS_Store similarity index 92% rename from jokes-bot-v3.0/.DS_Store rename to jokes_bot/.DS_Store index 7595df5..3bdfc7d 100644 Binary files a/jokes-bot-v3.0/.DS_Store and b/jokes_bot/.DS_Store differ diff --git a/jokes_bot/README.md b/jokes_bot/README.md new file mode 100644 index 0000000..ec4b25a --- /dev/null +++ b/jokes_bot/README.md @@ -0,0 +1,207 @@ +# Step-by-Step Complete Setup Guide + +## Prerequisites + +Before starting, ensure you have Python 3.x installed on your system. + +## Check Your Python Installation + +Open PowerShell or Terminal: + +Press Windows + R, type `powershell`, press Enter (on Windows) + +Check Python Version: + +```bash +python --version +# Should show: Python 3.x.x + +# If that doesn't work, try: +python3 --version +# Or on some systems: +py --version +``` + +## Create Your Project Folder + +Organize your files properly from the start. + +Open PowerShell, Terminal, or Command Prompt: + +Make sure you're not in the Python shell (should see C:\> or PS C:\>). + +Navigate to Desktop or Documents: + +Let's create a folder on your Desktop for easy access: + +```bash +# Go to Desktop (Windows) +cd Desktop + +# Create a new folder for your project +mkdir project_folder + +# Go into your new folder +cd project_folder + +# Verify you're in the right place +pwd +# Should show: C:\Users\YourName\Desktop\project_folder +# Or use 'ls' to see files (should be empty) +ls +``` + +**Best Practice:** Keep all related files in one folder for easy management. + +## Set Up Virtual Environment (venv) + +Isolate project dependencies for clean development. + +### Why Virtual Environment? + +- Keeps project dependencies separate +- Avoids version conflicts between projects +- Makes sharing and deployment easier + +### Create Virtual Environment: + +Make sure you're in your [project_folder](file:///Users/home/YandexDisk/TECHNOLYCEUM/ict/Year/2025/ai/ai6/ai6-m3/ai6-m3/jokes_bot/v4.0/database..py#L1-L45), then run: + +```bash +# Create virtual environment named 'venv' +python -m venv venv + +# or + +python3 -m venv venv + +# Check if venv folder was created +ls +# You should see a 'venv' folder in the list +``` + +### Activate Virtual Environment: + +#### On Windows (PowerShell): + +```bash +venv\Scripts\Activate.ps1 +# If you get an error about execution policy, run this first: +Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser +venv\Scripts\Activate.ps1 +``` + +#### On Windows (Command Prompt): + +```cmd +venv\Scripts\activate +``` + +#### On Mac/Linux: + +```bash +source venv/bin/activate +``` + +**Success Indicator:** You should see `(venv)` at the start of your command line. + +## Install Required Libraries + +Get the Python packages needed for this project. + +First, activate your venv: + +Make sure you see `(venv)` before the prompt. + +Install required packages: + +```bash +# Install the required library +pip install package-name==version.number + +# Verify installation +pip show package-name +# Should show the installed version +``` + +Create Requirements File: + +```bash +pip freeze > requirements.txt + +# View the requirements file +type requirements.txt +# (Mac/Linux: use 'cat requirements.txt' instead of 'type') +``` + +**Why this matters:** Anyone can install exact same versions with `pip install -r requirements.txt` + +## Using IDLE Editor + +To open Python IDLE editor: + +### On Windows: + +```bash +# Launch IDLE (blank new file) +py -m idlelib.idle + +# OR (depending on your Python installation) +python -m idlelib.idle + +# Open an existing file +py -m idlelib.idle "C:\path\to\your\file.py" +``` + +### On Mac: + +```bash +# Launch IDLE (blank new file) +python3 -m idlelib.idle + +# OR (if installed) +idle3 + +# Open an existing file +python3 -m idlelib.idle ~/path/to/your/file.py +``` + +### On Linux: + +```bash +# Launch IDLE (blank new file) +python3 -m idlelib.idle + +# OR (if installed) +idle3 + +# Open an existing file +python3 -m idlelib.idle /path/to/your/file.py +``` + +## Copy Existing Code + +Start with our working code and modify it. + +### Create main file: + +In your [project_folder](file:///Users/home/YandexDisk/TECHNOLYCEUM/ict/Year/2025/ai/ai6/ai6-m3/ai6-m3/jokes_bot/v4.0/database..py#L1-L45), create a new file: + +```bash +# Using Python IDLE or any text editor: +notepad app.py +# (Or use VS Code, Sublime Text, or Python's IDLE) +``` + +### Expected Folder Structure: + +``` +project_folder/ +├── app.py # Main file +├── requirements.txt # Python dependencies +└── venv/ # Virtual environment +``` + +## Final Steps + +Once you have completed all the steps above, you'll have a properly configured Python development environment ready for your project. Remember to always activate your virtual environment (`source venv/bin/activate` on Mac/Linux or `venv\Scripts\Activate.ps1` on Windows) before starting work on your project. \ No newline at end of file diff --git a/jokes-bot-v3.0/__pycache__/database.cpython-39.pyc b/jokes_bot/__pycache__/database.cpython-39.pyc similarity index 100% rename from jokes-bot-v3.0/__pycache__/database.cpython-39.pyc rename to jokes_bot/__pycache__/database.cpython-39.pyc diff --git a/jokes-bot-v3.0/jokes_v1.py b/jokes_bot/v1.0/jokes_v1.py similarity index 100% rename from jokes-bot-v3.0/jokes_v1.py rename to jokes_bot/v1.0/jokes_v1.py diff --git a/jokes-bot-v3.0/jokes_v2.py b/jokes_bot/v2.0/jokes_v2.py similarity index 100% rename from jokes-bot-v3.0/jokes_v2.py rename to jokes_bot/v2.0/jokes_v2.py diff --git a/jokes-bot-v3.0/jokes.db-journal b/jokes_bot/v3.0/.DS_Store similarity index 55% rename from jokes-bot-v3.0/jokes.db-journal rename to jokes_bot/v3.0/.DS_Store index 34c22e8..b05ca71 100644 Binary files a/jokes-bot-v3.0/jokes.db-journal and b/jokes_bot/v3.0/.DS_Store differ diff --git a/Joke Bot_ Telegram & SQLite Integration.html b/jokes_bot/v3.0/Joke Bot_ Telegram & SQLite Integration.html similarity index 100% rename from Joke Bot_ Telegram & SQLite Integration.html rename to jokes_bot/v3.0/Joke Bot_ Telegram & SQLite Integration.html diff --git a/Lesson Slides Template.html b/jokes_bot/v3.0/Lesson Slides Template.html similarity index 100% rename from Lesson Slides Template.html rename to jokes_bot/v3.0/Lesson Slides Template.html diff --git a/jokes-bot-v3.0/README.md b/jokes_bot/v3.0/README.md similarity index 100% rename from jokes-bot-v3.0/README.md rename to jokes_bot/v3.0/README.md diff --git a/jokes-bot-v3.0/database.py b/jokes_bot/v3.0/database.py similarity index 100% rename from jokes-bot-v3.0/database.py rename to jokes_bot/v3.0/database.py diff --git a/jokes-bot-v3.0/jokes.db b/jokes_bot/v3.0/jokes.db similarity index 98% rename from jokes-bot-v3.0/jokes.db rename to jokes_bot/v3.0/jokes.db index a699084..67dc104 100644 Binary files a/jokes-bot-v3.0/jokes.db and b/jokes_bot/v3.0/jokes.db differ diff --git a/jokes-bot-v3.0/jokes_v3.py b/jokes_bot/v3.0/jokes.py similarity index 100% rename from jokes-bot-v3.0/jokes_v3.py rename to jokes_bot/v3.0/jokes.py diff --git a/jokes-bot-v3.0/requirements.txt b/jokes_bot/v3.0/requirements.txt similarity index 100% rename from jokes-bot-v3.0/requirements.txt rename to jokes_bot/v3.0/requirements.txt diff --git a/jokes-bot-v3.0/sample_jokes.sql b/jokes_bot/v3.0/sample_jokes.sql similarity index 100% rename from jokes-bot-v3.0/sample_jokes.sql rename to jokes_bot/v3.0/sample_jokes.sql diff --git a/jokes_bot/v4.0/.DS_Store b/jokes_bot/v4.0/.DS_Store new file mode 100644 index 0000000..b05ca71 Binary files /dev/null and b/jokes_bot/v4.0/.DS_Store differ diff --git a/jokes_bot/v4.0/AI Joke Bot v2 - Community Ratings Added!.html b/jokes_bot/v4.0/AI Joke Bot v2 - Community Ratings Added!.html new file mode 100644 index 0000000..05213f0 --- /dev/null +++ b/jokes_bot/v4.0/AI Joke Bot v2 - Community Ratings Added!.html @@ -0,0 +1,969 @@ + + +
+ + +