Released a TOML library with zero dependencies in Rust.

voluntas — Sat, 07 Mar 2026 05:38:59 +0000

Shiguredo has begun shifting its development focus from C++ to Rust. As part of this transition, we've been implementing various libraries in Rust, and this time we've released a TOML library.

By default, Shiguredo uses the JSONC format when developing applications in Rust. JSONC is an incompatible extension of JSON that allows comments and trailing commas, making it convenient to use.

Additionally, the nojson dependency-free JSON library supports it.
However, Rust is primarily designed for TOML usage. Despite this, the default library does not include TOML support, and most major TOML libraries have significant dependencies. Therefore, we decided to develop our own TOML implementation with minimized dependencies.

shiguredo/toml-rs

Dependencies: 0
Supports TOML v1.0.0 and v1.1.0 specifications
Compatible with toml-test
Fuzzing support
Rewriting functionality

toml-test is a testing suite officially provided by the TOML project. A score of 100% indicates full compatibility, making this product technically "fully compatible."

We have prioritized robustness by thoroughly implementing fuzzing and ensuring the code remains stable under unexpected inputs.

Following user requests, we've added rewriting functionality. We implemented this feature by adapting nojson's positional tracking mechanism. After addressing several identified bugs, we've released this version.

https://github.com/shiguredo/toml-rs

Summary

While we strive to minimize dependencies by building our own libraries, the result is both comfortable to use and highly maintainable. The reduced dependency footprint makes maintenance easier, and having our own libraries provides the advantage of complete control.

zerolog と lumberjack と io.MultiWriter

voluntas — Fri, 03 Jan 2020 05:31:19 +0000

最近 Go で小さなミドルウェアと小さなウェブアプリを書いています。その際に欲しくなるのがログ出力の仕組みとログローテーションの仕組みです。

ログライブラリに対する要望

ログ出力は JSON できること
JSON 出力の場合はログレベルを指定しないでできること
独自フォーマットにも対応していること

ログローテーションライブラリに対する要望

組み込みが簡単であること

zerolog

rs/zerolog: Zero Allocation JSON Logger

性能は特に求めていないのですが、一通り欲しかった機能があったので zerolog を採用しました。

良いところ

logger.Log() でログレベルなしで出力できる
logger.Err(err) と err がきれいに出力できる
logger.Str("abc", xyz).Int("123", 234) とわかりやすく型付きでログを定義できる
zerolog.ConsoleWriter を使うことで独自フォーマットを定義できる
タイムフォーマットが気軽に利用可能
UTC 出力にしようと思った時、簡単にできた

良くないところ

JSON ベースなので仕方ないが key=value の順番指定ができない

lumberjack

natefinch/lumberjack: lumberjack is a log rolling package for Go

良いところ

簡単に組み込める

悪いところ

特になし

使ってみる

stdout と file 両方に出力するように、 MultiWriter を使っています。

io - The Go Programming Language

package main

import (
    "io"
    "os"
    "time"

    "github.com/rs/zerolog"
    "gopkg.in/natefinch/lumberjack.v2"
)

func main() {
    zerolog.TimeFieldFormat = time.RFC3339Nano

    writer := &lumberjack.Logger{
        Filename: "test.log",
        // メガバイト
        MaxSize:    10,
        MaxBackups: 5,
        // 日
        MaxAge: 1,
        // デフォルトは無効
        Compress: true,
    }

    // ここで stdout とファイルの両方に書き出すようにする
    writers := io.MultiWriter(os.Stdout, writer)
    log := zerolog.New(writers).With().Timestamp().Logger()

    log.Log().
        Int("baz", 123).
        Msg("hello world")
}

DEV Community: Shiguredo Inc.

Released a TOML library with zero dependencies in Rust.

shiguredo/toml-rs

Summary

zerolog と lumberjack と io.MultiWriter

ログライブラリに対する要望

ログローテーションライブラリに対する要望

zerolog

良いところ

良くないところ

lumberjack

良いところ

悪いところ

使ってみる