g18n-dev — g18n の開発ツールと CLI

Tool

概要

g18n-dev は、Gleam 向け国際化ライブラリ g18n のための開発ツールセットとコマンドラインインターフェースを提供するリポジトリです。ローカライズ用データ(Flat JSON など)のソースから Gleam の翻訳モジュールを生成する機能を持ち、生成物は Gleam コードとしてプロジェクトに組み込むことができます。Hex 上でパッケージ化されており、gleam add で導入可能。小規模ながら翻訳生成の自動化と型安全性の向上を狙ったツールです。

GitHub

リポジトリの統計情報

  • スター数: 2
  • フォーク数: 0
  • ウォッチャー数: 2
  • コミット数: 3
  • ファイル数: 8
  • メインの言語: Gleam

主な特徴

  • Gleam で書かれた小型の CLI ツール群で、翻訳ソースから Gleam モジュールを生成
  • Flat JSON 等のフォーマットを元に、型安全な翻訳モジュールを出力
  • Hex(g18n_dev)で公開され、gleam add で簡単に導入可能
  • g18n 本体と連携して、プロジェクト内での翻訳運用をシンプルにする設計

技術的なポイント

g18n-dev は Gleam エコシステムに則った実装が特徴です。Gleam は型安全で Erlang/BEAM 上で動く言語のため、翻訳データを Gleam のモジュールとしてコード生成することで、実行時の型エラーやキーの打ち間違いを減らせます。CLI 部分は入力として複数のファイルフォーマット(README にある Flat JSON を含む)を受け取り、パースして Gleam のソースコード(関数や定数としての翻訳マップ)を生成する処理フローを持つと推測されます。

パッケージ化は Hex を利用しており、gleam.toml を介した依存管理とビルド設定が行われています。小規模リポジトリのため内部はシンプルで、ファイル単位のパーサー、テンプレート化されたコード生成ロジック、CLI の引数処理(コマンド群の登録と実行)が主要な実装ポイントです。g18n 本体との親和性を保つために、生成されるコードは g18n の API を意識した形(関数呼び出しやデータ構造)になっており、既存の i18n ワークフローに自然に組み込めます。

拡張性の面では「新しい入力フォーマットの追加」「生成テンプレートのカスタマイズ」「CI における自動生成ステップの導入」などが考えられ、Gleam の型システムを活かしたテスト(生成コードのコンパイル確認)や、CI 上での差分検出によるレビュー運用がしやすい設計です。小さなコードベースは学習コストを抑えつつ、g18n エコシステムを利用するプロジェクトに対して実用的な自動化を提供します。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .github: dir
  • .gitignore: file
  • CHANGELOG.md: file
  • README.md: file
  • gleam.toml: file

…他 3 ファイル

まとめ

g18n と組み合わせて翻訳生成を自動化する、Gleam ベースの軽量 CLI ツール群です。

リポジトリ情報:

READMEの抜粋:

g18n-dev

Package Version Hex Docs

Development tools and CLI for the g18n internationalization library for Gleam.

Installation

gleam add g18n_dev@1

Usage

The CLI provides commands to generate Gleam translation modules from various file formats:

Generate from Flat JSON File…