Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/spriteovo/spdlog-rs
Fast and combinable Rust logging crate
https://github.com/spriteovo/spdlog-rs
crate library log logging rust spdlog
Last synced: 8 days ago
JSON representation
Fast and combinable Rust logging crate
- Host: GitHub
- URL: https://github.com/spriteovo/spdlog-rs
- Owner: SpriteOvO
- License: apache-2.0
- Created: 2021-12-18T04:28:01.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-04-02T19:30:49.000Z (7 months ago)
- Last Synced: 2024-04-02T20:32:51.436Z (7 months ago)
- Topics: crate, library, log, logging, rust, spdlog
- Language: Rust
- Homepage: https://crates.io/crates/spdlog-rs
- Size: 613 KB
- Stars: 98
- Watchers: 5
- Forks: 9
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# spdlog-rs
[](https://github.com/SpriteOvO/spdlog-rs)
[](https://crates.io/crates/spdlog-rs)
[](https://docs.rs/spdlog-rs)
[](https://github.com/SpriteOvO/spdlog-rs/actions/workflows/ci.yml)
Fast, highly configurable Rust logging crate, inspired by the C++ logging library [spdlog].
## Features
- Very fast (see [Benchmarks]).
- Asynchronous support.
- Compatible with `log` crate.
- Custom log formats:
- compile-time zero-cost pattern or runtime pattern;
- manually implementing for more flexibility.
- Various combinable sinks:
- standard streams with optional color support;
- files (single file, rotating hourly, daily, periodically or by file size);
- platform-specific (e.g. `journald` for Linux and `OutputDebugStringW` for Windows);
- ... and able to implement one yourself.
- Configuring via environment variables or TOML[^1].
- More readable level filters.
[^1]: TOML deserialization support is working in progress, tracking issue [#25]
## Getting started
Add this to `Cargo.toml`:
```toml
[dependencies]
spdlog-rs = "0.4"
```
The documentation of this crate is hosted on [docs.rs], and you can learn examples under [./examples] directory along with it.
If you have any trouble while using this crate, please don't hesitate to [open a discussion] for help. For feature requests or bug reports, please [open an issue].
## Supported Rust versions
The current minimum supported Rust version is 1.60.
`spdlog-rs` is built against the latest Rust stable release, it is not guaranteed to build on Rust versions earlier than the minimum supported version.
`spdlog-rs` follows the compiler support policy that the latest stable version and the 3 most recent minor versions before that are always supported. For example, if the current latest Rust stable version is 1.61, the minimum supported version will not be increased past 1.58. Increasing the minimum supported version is not considered a semver breaking change as long as it complies with this policy.
## License
Licensed under either of
* Apache License, Version 2.0 ([LICENSE-APACHE](/LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](/LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.
## Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
[spdlog]: https://github.com/gabime/spdlog
[Benchmarks]: https://github.com/SpriteOvO/spdlog-rs/blob/main/spdlog/benches/README.md
[#25]: https://github.com/SpriteOvO/spdlog-rs/issues/25
[./examples]: https://github.com/SpriteOvO/spdlog-rs/tree/main/spdlog/examples
[docs.rs]: https://docs.rs/spdlog-rs/
[open a discussion]: https://github.com/SpriteOvO/spdlog-rs/discussions/new
[open an issue]: https://github.com/SpriteOvO/spdlog-rs/issues/new/choose