# Sopel IRC Bot

**Category:** Standalone_Bot
**Original Author:** Unknown

## Description
Sopel is a versatile, Python-based IRC bot designed to automate tasks on IRC channels. It supports various commands, event handling, and module loading for extended functionality.

## Key Features
- Supports command triggers using `!` or `.`
- Implements an access/user-level system with permissions
- Automates text, join, kick, and op actions
- Loads modules from Python files for additional features

## File Analysis
- **checkstyle.sh** — Script to check source code style.
- **ci_build.sh** — Build script for continuous integration.
- **conftest.py** — Pytest configuration file ignoring specific tests.
- **pytest_run.py** — Runs pytest with custom settings.
- **setup.py** — Setup script for packaging and distributing Sopel.
- **sopel.py** — Main entry point of the bot.
- **release.sh** — Script to release a version of Sopel.
- **suppress-warnings.py** — Suppresses warnings during startup.
- **update_db.py** — Database migration script.
- **makerpm.py** — Script to create an RPM package.
- **make.bat** — Batch file for Sphinx documentation build.
- **conf.py** — Configuration settings for Sphinx documentation.
- **__init__.py** — Initializes the bot and sets up environment.
- **bot.py** — Core functionality of the IRC bot.
- **coretasks.py** — Tasks that run in the background without user interaction.
- **db.py** — Database management module.
- **formatting.py** — Formatting functions for IRC messages.
- **irc.py** — IRC protocol handling and utility functions.
- **loader.py** — Module loading and initialization.
- **logger.py** — Logging handler for the bot.
- **module.py** — Decorators and tools for creating plugin commands.
- **run_script.py** — Entry point to run Sopel as a script.
- **test_tools.py** — Tools for testing modules.
- **trigger.py** — Parsing and handling of IRC messages.
- **web.py** — Web-related functions (deprecated in version 6.2.0).
- **config/core_section.py** — Core configuration section definitions.
- **admin.py** — Administration module with kick rejoin functionality.
- **adminchannel.py** — Channel management commands for administrators.
- **announce.py** — Sends an announcement to all channels.
- **bugzilla.py** — Bug reporting and issue tracking.
- **calc.py** — Calculator module.
- **clock.py** — Time-related commands.
- **countdown.py** — Countdown command.
- **currency.py** — Currency conversion functionality.
- **dice.py** — Dice rolling module.
- **etymology.py** — Etymology lookup module.
- **find.py** — Spell correction and replacement using sed notation.
- **find_updates.py** — Update checking for Sopel.
- **help.py** — Help command documentation.
- **ip.py** — GeoIP lookup functionality.
- **ipython.py** — IPython console integration.
- **isup.py** — Website status checker.
- **lmgtfy.py** — Let me Google that for you module.
- **meetbot.py** — Meeting logging and management.
- **movie.py** — Movie information retrieval.
- **ping.py** — Greeting and insult commands.
- **pronouns.py** — Pronoun handling and substitution.
- **rand.py** — Random number generation.
- **reddit.py** — Reddit content fetching.
- **reload.py** — Module reloading functionality.
- **remind.py** — Reminder management.
- **safety.py** — URL safety alerts.
- **search.py** — Web search commands.
- **seen.py** — User activity tracking.
- **spellcheck.py** — Spell checking and correction.
- **tell.py** — Tell and ask module for private messages.
- **tld.py** — Top-level domain information.