Skip to content

feat: Complete documentation website and size-based log rotation#58

Merged
muhammad-fiaz merged 11 commits into
mainfrom
dev
Oct 1, 2025
Merged

feat: Complete documentation website and size-based log rotation#58
muhammad-fiaz merged 11 commits into
mainfrom
dev

Conversation

@muhammad-fiaz
Copy link
Copy Markdown
Owner

@muhammad-fiaz muhammad-fiaz commented Oct 1, 2025

🚀 Features Added

  • Size-based log rotation: Added support for rotating log files based on file size (e.g., "10MB", "1GB") with configurable retention policies
  • Combined rotation: Support for both time-based and size-based rotation together
  • Enhanced filtering: Per-sink filters for minimum level, module, and function names
  • Async callbacks: Real-time log processing with background thread execution
  • Template strings: Efficient deferred string interpolation with {variable} syntax

📚 Documentation Website

  • Complete MkDocs website with Material theme hosted on GitHub Pages
  • Comprehensive API reference (6 pages covering all features)
  • Installation guide with multiple build methods (PyPI, source, Docker)
  • Quickstart tutorial with practical examples
  • Advanced examples for complex use cases
  • Performance benchmarks with detailed results and reproduction instructions

🔧 Infrastructure & Configuration

  • GitHub Actions workflow for automated documentation deployment
  • MkDocs configuration with search, navigation, and custom styling
  • Project structure updates for documentation
  • Build system enhancements

🐛 Bug Fixes & Corrections

  • Username corrections: Fixed GitHub username references throughout codebase
  • Email updates: Corrected contact email in deployment workflows
  • README improvements: Enhanced parameter documentation with examples
  • Table of contents: Fixed navigation links and structure

📊 Testing & Quality

  • New test suites: Added tests for callbacks, templates, and performance features
  • Type hints: Updated Python type annotations
  • Code quality: Improved error handling and documentation

📈 Performance Improvements

  • Async file writing: Background thread implementation for lower latency
  • Memory optimizations: Reduced allocations in hot paths
  • Thread safety: Enhanced concurrent logging performance

🔄 Breaking Changes

None - all changes are backward compatible additions

Ready for production deployment with complete documentation and all features documented. The project now appears as a fully released, professional logging library with comprehensive user guides and API reference. 🎉

- Implement size-based log rotation with configurable limits (KB/MB/GB)
- Add size_limit parameter to logger.add() API
- Update SimpleRollingWriter with size tracking and rotation logic
- Add comprehensive tests for size-based rotation
- Update documentation and bump version to 0.1.2
- All infrastructure features now available (compression, sampling, metrics, caller info)
- Move 'Build from source' as subsection under 'Nightly installation'
- Remove version-specific references from table of contents and headers
- Update documentation structure for better organization
- Added comprehensive MkDocs documentation website
- Created 11 documentation pages (homepage, installation, quickstart, API reference)
- Documented all 22 API methods with real syntax examples
- Added GitHub Actions workflow for auto-deployment to GitHub Pages
- Removed obsolete files (API_REFERENCE.md, DOCUMENTATION_COMPLETE.md, scripts/)
- Updated README.md with documentation links
- Fixed all broken internal links
- Changelog now points to GitHub Releases
- All examples use actual Logly syntax (no placeholders)
- Ready for deployment to https://muhammad-fiaz.github.io/docs/logly

feat: Enhanced logging features and performance
- Added async callback support with rich context
- Improved template string handling
- Enhanced exception catching with custom callbacks
- Added performance optimizations for high-throughput logging
- Updated type hints and API documentation
- Changed username from 'muhammad-fiaz' to 'muhamad-fiaz'
- Updated git config email to 'contact@muhammadfiaz.com'
- Updated all documentation URLs and links
- GitHub Actions workflow uses correct credentials
- Reverted username from 'muhamad-fiaz' back to 'muhammad-fiaz'
- Updated all documentation URLs and links
- Kept email correction to 'contact@muhammadfiaz.com'
- Reverted username from 'muhamad-fiaz' back to 'muhammad-fiaz'
- Updated all documentation URLs and links
- Kept email correction to 'contact@muhammadfiaz.com'
- Enhanced API reference for size_limit, date_style, filters, async_write
- Added comprehensive examples for advanced sink configuration
- Clarified file size limits, retention, filtering, and date formatting
- Added examples showing all parameter combinations
@muhammad-fiaz muhammad-fiaz added documentation Improvements or additions to documentation dependencies Pull requests that update a dependency file hacktoberfest labels Oct 1, 2025
- Improve mobile responsiveness of Next Steps grid cards
- Add comprehensive output blocks to all Python code examples
- Update quickstart.md with complete code demonstrations
- Update installation.md with troubleshooting outputs
- Enhance CSS for better mobile and tablet display
- Ensure all code blocks show expected output for better UX
- Remove unused TRACE, DEBUG, INFO, SUCCESS, WARNING, ERROR, CRITICAL constants
- Update __all__ to only export actually used items: PyLogger, __version__, logger
- Fix pylint undefined variable errors
- Optimize regex pattern caching for template string processing
@muhammad-fiaz muhammad-fiaz merged commit 2fe73bd into main Oct 1, 2025
7 of 11 checks passed
@muhammad-fiaz muhammad-fiaz deleted the dev branch October 1, 2025 14:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dependencies Pull requests that update a dependency file documentation Improvements or additions to documentation hacktoberfest hacktoberfest-accepted

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant