feat: Add logging util and CLI params for logging output

[mkmeral]

Description

This PR adds logging system to the Strands CLI. The implementation includes:

1. Command-line arguments for configuring logging:

   • --log-level: Set logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
   • --log-file: Specify output file path for logs

2. A new utility module logging_utils.py with functions for:

   • Configuring logging with file output
   • Getting available log levels
   • Checking logging status
   • Setting log levels for specific modules

3. Integration into the main CLI entry point to initialize logging based on user preferences

4. Comprehensive unit tests in tests/utils/test_logging_utils.py covering:

   • Log level validation
   • File handler creation
   • Directory creation
   • Exception handling
   • Logger state management
   • All edge cases and error conditions

This enhancement will help users debug issues, track agent behavior, and maintain operation logs for production deployments.

Related Issues

[No specific issue reference provided - please add if applicable]

Documentation PR

[Link to associated documentation PR when created]

Type of Change

• New feature

Testing

The changes have been thoroughly tested with:

• hatch fmt --linter - All linting checks pass
• hatch fmt --formatter - Code formatting is consistent
• hatch test --all - Full test suite passes

Additionally, manual testing with various logging configurations confirms the functionality:

# Test with default logging (INFO level)
strands --log-file=strands.log

# Test with debug level
strands --log-level=DEBUG --log-file=debug.log

# Verify log file is created with appropriate content
cat debug.log

See example

2025-05-25 11:06:53,210 - root - INFO - Logging configured with level: DEBUG
2025-05-25 11:06:53,210 - root - INFO - Log file: /Users/murmeral/.strands/logs/2025-05-25_11-06-52-DEBUG.log
2025-05-25 11:06:53,210 - root - INFO - Strands CLI started with log level DEBUG
2025-05-25 11:06:53,210 - root - INFO - Log file: /Users/murmeral/.strands/logs/2025-05-25_11-06-52-DEBUG.log
2025-05-25 11:06:53,210 - strands.models.bedrock - DEBUG - config=<{'model_id': 'us.anthropic.claude-3-7-sonnet-20250219-v1:0', 'max_tokens': 64000, 'additional_request_fields': {'thinking': {'type': 'enabled', 'budget_tokens': 2048}}}> | initializing
2025-05-25 11:06:53,211 - botocore.hooks - DEBUG - Changing event name from creating-client-class.iot-data to creating-client-class.iot-data-plane
...

Checklist

• I have read the CONTRIBUTING document
• I have added tests that prove my fix is effective or my feature works
• I have updated the documentation accordingly
• I have added an appropriate example to the documentation to outline the feature
• My changes generate no new warnings
• Any dependent changes have been merged and published

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice

[awsarron]

Thanks for your contribution @mkmeral! I added a few comments to follow up on.