feat: enhance SDK architecture and documentation

[dylanburkey]

SDK Architecture and Documentation Enhancements

Overview

This PR improves the SDK's architecture and documentation to make it more user-friendly, maintainable, and robust.

Key Changes

Architecture Improvements

• Added configuration management system for flexible settings
• Added custom exception handling for better error management
• Updated utility functions with proper error handling and validation
• Added comprehensive testing framework with fixtures

Documentation Additions

• Added configuration guide explaining all settings
• Added error handling guide with examples
• Added testing guide with best practices
• Updated main README with documentation links

Testing Infrastructure

• Added test fixtures for common testing needs
• Added utility function tests
• Added configuration system tests
• Added validation tests

Testing

• All new code includes unit tests
• Test coverage added for configuration system
• Test coverage added for utility functions
• All tests passing

Documentation

New documentation added:

• docs/configuration.md: Configuration system guide
• docs/error-handling.md: Error handling guide
• docs/testing.md: Testing framework guide

Related Issues

N/A

Checklist

• Code follows PEP 8 style guidelines
• All new code includes tests
• Documentation has been updated
• Changes are focused and easy to review
• No breaking changes to existing functionality

[dylanburkey]

@celesteanglm for some reason I'm unable to add labels. Never had an issue like this before, trying to figure out what the issues is. My apologies.

Overview

This PR improves the GAME SDK's reliability and developer experience by enhancing API integration, adding comprehensive documentation, and providing better development tools.

Core SDK Improvements

• 🔄 Update API endpoint to use api.virtuals.io/api
• ✨ Add comprehensive response handling for different status codes (200-204)
• 🐛 Fix agent creation functionality to handle empty responses correctly

Documentation Enhancements

• 📚 Add detailed testing guide (docs/testing_guide.md)
• 🔍 Create examples documentation with test SDK guide (examples/README.md)
• 🛠️ Add development requirements file (requirements-dev.txt)

Developer Experience

• 🧪 Add test_sdk.py script for easy SDK verification
• 🔧 Improve .gitignore patterns for Python development
• 📝 Enhance error messages and handling

Testing

The changes have been tested with:

• SDK installation verification
• API authentication
• Agent creation
• Various response types (200, 204, empty responses)

Breaking Changes

None. All changes are backward compatible.

Related Issues

Addresses SDK reliability and documentation needs for better developer onboarding.

Checklist

• Code follows project style guidelines
• Documentation has been updated
• Tests have been added/updated
• All tests pass
• No changes to core README.md