NEWS
stenographer 1.1.0
BREAKING CHANGES
NEW FEATURES
- Access set LogLevel: Use
Stenographer$get_level
to read the current logging level; active field.
IMPROVEMENTS
- Stenographer$set_level method checks value: The
set_level
method now validates the input value to ensure it is a valid logging level.
DOCUMENTATION
DEVELOPMENT
NOTES
stenographer 1.0.0 (2025-01-16)
BREAKING CHANGES
NEW FEATURES
- Hierarchical Logging Levels: Implemented multiple logging levels (
ERROR
, WARNING
, INFO
, OFF
) to control message output granularity.
- File-Based Logging: Added support for logging messages to user-specified file paths, enabling persistent log storage.
- Database Logging Integration: Integrated database support using
DBI
and RSQLite
for efficient and scalable log management.
- Contextual Logging: Introduced contextual logging capabilities to attach metadata to log entries, enhancing traceability.
- Customisable Message Formatting: Enabled custom message formatting functions to tailor log output according to user preferences.
- Coloured Console Output: Incorporated
crayon
for colour-coded console messages, improving readability and distinguishing log levels.
- Parallel Processing Support: Developed the
messageParallel
function to handle message output from parallel processes seamlessly.
- Structured Error Reporting: Implemented JSON formatting for structured error reporting, facilitating easier parsing and analysis of log data.
- Comprehensive Documentation: Created detailed vignettes and function documentation to guide users through package features and usage scenarios.
IMPROVEMENTS
- Enhanced Package Structure: Optimized the internal organization of the package for better maintainability and scalability.
- Robust Error Handling: Improved error handling mechanisms to provide more informative and consistent error messages across the package.
- Performance Optimization: Streamlined logging operations to minimize performance overhead, ensuring efficient execution even in high-throughput environments.
- Refined R6 Class Implementation: Strengthened the
Stenographer
R6 class for more reliable and flexible logging functionality.
- Dependency Management: Managed package dependencies effectively, ensuring that all required packages are correctly specified and utilized within the package codebase.
DOCUMENTATION
- Detailed Vignettes: Developed comprehensive vignettes demonstrating various use cases, configuration options, and best practices for using the
stenographer
package.
- Enhanced Function Documentation: Expanded function documentation with extensive examples and clearer explanations to assist users in understanding and utilizing package functions effectively.
- Comprehensive README: Updated the
README.md
with installation instructions, feature overviews, and quick start guides to provide users with a clear entry point to the package.
DEVELOPMENT
- Continuous Integration Setup: Established GitHub Actions workflows for automated testing, coverage reporting, and package checks to ensure code quality and reliability.
- Comprehensive Test Suite: Implemented a robust test suite using
testthat
to validate package functionality and prevent regressions.
- CRAN Policy Compliance: Ensured that the package adheres to CRAN submission policies, facilitating smooth package release and maintenance.
- Dependency Management: Managed package dependencies effectively, ensuring that all required packages are correctly specified and utilized within the package codebase.
NOTES
- First Official Release: This is the inaugural release of the
stenographer
package, marking its availability for CRAN submission and general use.
- R Version Compatibility: The package is compatible with R versions 4.1.0 and above, ensuring broad usability across different R environments.