How eclipse-opensovd/odx-converter works
The product is an ODX/PDX-to-MDD converter with CLI workflows for conversion, signing, verification, and inspection. Conversion reads PDX inputs, builds diagnostic-description chunks, applies plugins, and writes MDD output; the README documents optional job-file inclusion, audience filtering, and automatic signing. The source excerpts confirm chunk construction and plugin processing, but do not show every internal call or the sign/verify command implementations, so some relationships are documented at the CLI level.
Main entry points: Converter.kt Convert command · ChunkBuilder.kt Chunk builder · PluginHandling.kt Plugin handling · SignCommand.kt Sign command
Components 20
Conversion
- Convert command
converter/src/main/kotlin/Converter.kt - PDX inputs
- ODX parsing
converter/src/main/kotlin/Converter.kt - Link collection
converter/src/main/kotlin/ODXLinkCollector.kt - ODX collections
converter/src/main/kotlin/ODXCollection.kt - Collection grouping
converter/src/main/kotlin/ODXCollectionGroup.kt
MDD Format
- Description writer
converter/src/main/kotlin/DatabaseWriter.kt - Chunk builder
converter/src/main/kotlin/ChunkBuilder.kt - MDD container
database/src/main/proto/file_format.proto - Diagnostic model
database/src/main/kotlin/dataformat/DiagLayer.kt
Plugin System
- Plugin handling
converter/src/main/kotlin/PluginHandling.kt - Plugin contracts
converter-plugin-api/src/main/kotlin/converter/plugin/api/ConverterPlugin.kt - Compression plugin
converter-plugins-default/src/main/kotlin/converter/plugins/default/CompressionPlugin.kt - Hash verification
converter-plugins-default/src/main/kotlin/converter/plugins/default/HashVerificationPlugin.kt
MDD Commands
- Sign command
converter/src/main/kotlin/SignCommand.kt - Signing executor
converter/src/main/kotlin/SigningExecutor.kt - Verify command
converter/src/main/kotlin/VerifyCommand.kt - View command
viewer/src/main/kotlin/Viewer.kt - MDD files
Other components
- CLI user
Connections 24
- CLI user → Convert command: invokes
README.md - Convert command → PDX inputs: accepts
README.md - Convert command → ODX parsing: parses
converter/src/main/kotlin/Converter.kt - ODX parsing → Link collection: collects links
converter/src/main/kotlin/Converter.kt - Convert command → ODX collections: builds collections
converter/src/main/kotlin/Converter.kt - ODX collections → Collection grouping: groups inputs
converter/src/main/kotlin/ODXCollectionGroup.kt - Convert command → Chunk builder: builds chunks
converter/src/main/kotlin/Converter.kt - Chunk builder → Description writer: serializes description
- Description writer → Diagnostic model: encodes model
converter/src/main/kotlin/DatabaseWriter.kt - Chunk builder → MDD container: creates chunks
- Convert command → Plugin handling: processes chunks
converter/src/main/kotlin/Converter.kt - Plugin handling → Plugin contracts: invokes plugins
- Compression plugin → Plugin contracts: implements
converter-plugins-default/src/main/kotlin/converter/plugins/default/CompressionPlugin.kt - Plugin handling → Compression plugin: dispatches
- Convert command → MDD container: writes output
README.md - CLI user → Sign command: invokes
README.md - Sign command → Signing executor: delegates signing
- Sign command → MDD files: modifies in place
README.md - CLI user → Verify command: invokes
README.md - Verify command → Hash verification: uses verifier plugins
README.md - Hash verification → Plugin contracts: implements contract
- Verify command → MDD files: checks signatures
README.md - CLI user → View command: invokes
README.md - View command → MDD files: inspects
README.md