Skip to content

Release PR for 2025-12-07 14:07#27

Merged
disafronov merged 9 commits into
releasefrom
main
Dec 7, 2025
Merged

Release PR for 2025-12-07 14:07#27
disafronov merged 9 commits into
releasefrom
main

Conversation

@disafronov
Copy link
Copy Markdown
Owner

@disafronov disafronov commented Dec 7, 2025

Changelog (#27)

🐛 Bug Fixes

  • (logging) enhance error handling in SchemaLogger for JSON parsing and serialization

📚 Documentation

  • (README) add cache invalidation details for schema management
  • (README) enhance schema validation and error handling details
  • (logging) enhance schema validation error reporting and handling
  • (README) streamline schema validation and logging behavior explanations
  • (README) clarify schema caching behavior and thread safety

♻️ Refactoring

  • (logging) update error handling to use JSON format for validation errors

🧹 Chores

  • (workflow) improve main branch synchronization logic
  • (release) 0.1.3-rc.1

disafronov and others added 9 commits December 6, 2025 17:45
- Refined the GitHub Actions workflow for synchronizing the main branch with the release branch. Updated fetch commands to ensure the latest state is retrieved and enhanced checks for fast-forwarding or rebasing. This ensures a more robust and accurate update process for the main branch after releases.

Signed-off-by: Dmitrii Safronov <zimniy@cyberbrain.cc>
…ation errors

- Modified the error handling in SchemaLogger and schema validation functions to log validation errors in a structured JSON format. This change enhances machine readability and consistency in error reporting.
- Updated the README to reflect the new error message format, replacing the previous string format with a JSON structure that includes field, error, and value information.
- Adjusted tests to verify the new JSON error message format is correctly logged and processed.

Signed-off-by: Dmitrii Safronov <zimniy@cyberbrain.cc>
… and serialization

- Added defensive error handling in the SchemaLogger to manage potential JSON parsing and serialization issues when logging validation errors. This ensures that even if unexpected data corruption occurs, the logger can still produce a meaningful error message.
- Implemented fallback mechanisms to create structured error objects when parsing or serialization fails, improving the robustness of the logging system.

Signed-off-by: Dmitrii Safronov <zimniy@cyberbrain.cc>
## [0.1.3-rc.1](v0.1.2...v0.1.3-rc.1) (2025-12-07)

### Bug Fixes

* **logging:** enhance error handling in SchemaLogger for JSON parsing and serialization ([0417dc9](0417dc9))

Signed-off-by: Release Bot <noreply@github.com>
- Expanded the README to include information on the library's caching mechanisms, detailing the path cache and compiled schema cache. This addition clarifies how the library handles schema file changes and caching behavior, ensuring users understand the implications of schema file modifications on caching.

Signed-off-by: Dmitrii Safronov <zimniy@cyberbrain.cc>
- Updated the README to provide comprehensive information on schema validation processes, including the creation of `SchemaLogger` instances, error handling for schema problems, and the implications of schema structure on logging behavior.
- Added sections on schema root key restrictions and clarified the handling of validation errors, ensuring users understand how the library manages schema-related issues and the conditions under which fields are included in log records.

Signed-off-by: Dmitrii Safronov <zimniy@cyberbrain.cc>
- Expanded the `SchemaProblem` and `DataProblem` classes to provide detailed descriptions of validation errors, including examples for better clarity.
- Improved the `_create_validation_error_json` function to ensure consistent JSON serialization of error messages, enhancing security and readability.
- Updated the `SchemaLogger` to log validation errors in a structured JSON format, allowing for easier parsing and analysis by consumers of the log data.
- Added performance considerations and limitations in the schema compilation and validation processes to improve documentation and user understanding.

Signed-off-by: Dmitrii Safronov <zimniy@cyberbrain.cc>
…nations

- Revised the README to clarify the role of the JSON schema in validating `extra` fields for logging, emphasizing its importance as a contract between log producers and consumers.
- Enhanced sections on strictness guarantees, schema structure, and error handling to provide clearer guidance on how the library manages logging behavior and validation errors.
- Updated examples to illustrate the expected behavior when logging with valid and invalid data, ensuring users understand the implications of schema compliance.

Signed-off-by: Dmitrii Safronov <zimniy@cyberbrain.cc>
- Added a note regarding the caching of the schema, specifying that it is compiled once per process and requires an application restart for changes to take effect.
- Emphasized the thread safety of the library, ensuring users understand the implications of concurrent access to the schema.

Signed-off-by: Dmitrii Safronov <zimniy@cyberbrain.cc>
@github-actions github-actions Bot changed the title New release Release PR for 2025-12-07 14:07 Dec 7, 2025
@disafronov disafronov merged commit 35e79d4 into release Dec 7, 2025
14 checks passed
@disafronov
Copy link
Copy Markdown
Owner Author

🎉 This PR is included in version 0.1.3 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants