pytest-alerts 1.1.0

A pytest plugin for sending test results to Slack and Telegram

pytest-alerts

A pytest plugin that sends test results to Slack and Telegram with beautiful, customizable formatting.

Overview

pytest-alerts is a powerful pytest plugin that automatically sends your test results to Slack and Telegram. It provides:

• 📲 Real-time test notifications to Slack and Telegram
• 🎨 Modern, visually appealing message formatting
• 📊 Comprehensive test statistics with progress bars
• 🔍 Configurable error reporting and details
• ⚙️ Extensive customization options
• 🔄 Full compatibility with pytest-xdist

Quick Start

Installation

pip install pytest-alerts

Basic Usage

1. Configure your messaging platform:

   For Slack:

   pytest --slack_webhook=YOUR_WEBHOOK_URL
   

   For Telegram:

   pytest --telegram_token=BOT_TOKEN --telegram_chat_id=CHAT_ID
   

2. Run with both platforms:

   pytest --slack_webhook=URL --telegram_token=TOKEN --telegram_chat_id=ID
   

Configuration Options

Common Options

Option	Description	Default
--show_details	Include error details in notifications	False
--hide_errors	Hide error messages from notifications	False

Slack-specific Options

Option	Description	Required
--slack_webhook	Slack webhook URL	Yes
--slack_channel	Override default channel	No
--slack_username	Bot username	No
--slack_icon	Bot icon emoji	No

Telegram-specific Options

Option	Description	Required
--telegram_token	Bot API token	Yes
--telegram_chat_id	Target chat ID	Yes
--telegram_thread_id	Specific thread ID	No

Message Formatting

Default Format

Messages include:

• Test run summary (passed/failed/skipped)
• Progress bars for visual representation
• Duration of test run
• Error details (if enabled)
• Project/branch information (if available)

Customization

• Use --show_details for full error traces
• Use --hide_errors to omit error messages
• Platform-specific formatting options available

Advanced Usage

Environment Variables

Configure using environment variables:

export PYTEST_ALERTS_SLACK_WEBHOOK="your-webhook-url"
export PYTEST_ALERTS_TELEGRAM_TOKEN="your-bot-token"
export PYTEST_ALERTS_TELEGRAM_CHAT_ID="your-chat-id"

CI/CD Integration

Example GitHub Actions workflow:

steps:
  - uses: actions/checkout@v2
  - name: Run tests with notifications
    env:
      PYTEST_ALERTS_SLACK_WEBHOOK: ${{ secrets.SLACK_WEBHOOK }}
    run: |
      pip install pytest-alerts
      pytest --slack_webhook=$PYTEST_ALERTS_SLACK_WEBHOOK

Limitations

• Maximum message size varies by platform
• Rate limits apply (platform-specific)
• Some formatting options are platform-dependent

Contributing

We welcome contributions! Please see our Contributing Guide for details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

• 📖 Documentation
• 🐛 Issue Tracker
• 💬 Discussions

Changelog

See CHANGELOG.md for version history and changes.