Add Multiple Output Format Support for Artifacts

[sambhavnoobcoder]

Overview

This PR adds support for exporting artifacts to multiple file formats (.md, .txt, .pdf, .py) along with comprehensive test coverage. This enhancement allows users to flexibly convert and save their artifacts in different formats while maintaining content integrity.

Features

• Support for multiple output formats:
  • Markdown (.md)
  • Plain text (.txt)
  • PDF (.pdf)
  • Python (.py) with proper docstrings
• Automatic format-specific formatting
• Comprehensive error handling
• Extensive test coverage

Changes

• Added save_as method to Artifact class
• Implemented format-specific output handlers
• Added PDF generation support using reportlab
• Enhanced test suite with format-specific tests
• Added proper cleanup in test teardown
• Improved error handling and validation

Testing

• Added unit tests for all supported formats
• Added mock tests for file operations
• Added tests for error conditions

Documentation

• Updated existing docs with now being able to choose from multiple output types.
• Updated docstrings with new functionality
• Added examples for each format
• Updated type hints and validation rules

Screenshots

Here are screenshots showing:

1. Example outputs in different formats
2. Test coverage report
3. Documentation updates

Video Demonstration

Here is a short video demonstrating:

1. Converting artifacts to different formats
2. Test execution
   Here's the link for the same : https://drive.google.com/file/d/1Xq9EBUER5EB76uHkLiU9qpA5CHD9Z5DB/view?usp=sharing

Accessibility

• Text-based formats maintain accessibility
• PDF output follows accessibility guidelines
• Format conversion preserves content structure

---

📚 Documentation preview 📚: https://swarms--621.org.readthedocs.build/en/621/