reovim-driver-codec 0.14.4

Content codec driver for reovim (trait definitions only)
Documentation

Content codec driver for reovim.

This crate defines the trait interface for content encoding and decoding. It does NOT depend on any specific encoding library (e.g., encoding_rs). Those are implementation details of codec modules (server/modules/codec-*/).

Design Philosophy

This crate follows the Linux kernel "mechanism vs policy" principle:

  • Driver provides MECHANISM: The traits and stores define HOW codecs are registered, discovered, and invoked.
  • Modules provide POLICY: Codec modules decide WHAT encodings to support and HOW to detect/decode/encode them.

Architecture

server/lib/drivers/codec/               <-- Traits, stores, types
       ^
       |  implements
       |
server/modules/codec-utf8/             <-- UTF-8 codec
server/modules/codec-hex/              <-- Hex dump codec
server/modules/codec-cjk/              <-- CJK encoding codecs
server/modules/codec-legacy/           <-- Legacy encoding codecs

Components

  • [ContentCodec] — Decode raw bytes to text, encode text back to bytes
  • [ContentClassifier] — Detect content type from raw bytes
  • [ContentCodecFactory] — Create codec instances for content types
  • [ContentCodecFactoryStore] — Service registry for codec factories
  • [ContentClassifierStore] — Service registry for classifiers
  • [CodecSessionState] — Per-buffer codec metadata (session extension)
  • [ContentType] — Content type identifier
  • [CodecMetadata] — Round-trip encoding metadata
  • [DecodeResult] — Result of decoding (content + annotations + metadata)
  • [CodecError] — Error type for codec operations