cu29-log-derive
| Crates.io | cu29-log-derive |
| lib.rs | cu29-log-derive |
| version | 0.9.1 |
| created_at | 2024-07-29 18:30:56.153112+00 |
| updated_at | 2025-09-12 20:20:15.843411+00 |
| description | This is part of the text logging macros Copper. It cannot be used independently from the copper project. |
| homepage | https://github.com/copper-project |
| repository | https://github.com/copper-project/copper-rs |
| max_upload_size | |
| id | 1319099 |
| size | 38,128 |
Guillaume Binet (gbin)
documentation
README
Structured Logging Macros
The cu29_log_derive crate provides macros like !debug to enable structured logging, allowing you to efficiently log
data in
a binary format.
Example Usage
debug!("This string won't be stored nor interpreted on the robot", myvaluename = 42);
Instead of storing the complete formatted string in a log file, this macro captures a unique identifier for the format string and parameter names, then logs the values in a compact bincode format. This approach significantly improves logging efficiency.
Integration with Copper
If you are using this crate as part of a Copper project, no additional setup is required. The logs will automatically
integrate with the Unified Logger (cu29_unifiedlog), storing logs in the binary format.
Standalone Usage
For those using this crate independently of Copper, follow the example setup provided in cu_standalone_structlog to configure your logger.
Extracting Logs
You can extract and view your logs using either Rust or Python:
- Rust: Refer to the cu29_export module.
- Python: Use the provided script in readlog.py for Python support.