How gannettdigital/jstransform works
Main Components
a) Input Processing Layer:
• JSON Schema Parser
• XML Input Parser
• JSON Input Parser
• Schema Reference Resolver
b) Core Transform Engine:
• Transform Operations Processor
• Instance Transformer
• Schema Validator
• Schema Walker
c) Code Generation Layer:
• Struct Generator
• Avro Generator
• MessagePack Generator
• GraphQL Generator
d) Output Handlers:
• Generated Go Structs
• Serialization Code
• Schema Files
[Input Layer]
• ↓
[Processing Layer]
• ↓
[Generation Layer]
• ↓
[Output Layer]
Component Relationships
[JSON Schema + Transform Extensions] → [Schema Parser] → [Schema Validator]
• ↘ [Transform Engine] ← [Input Data (JSON/XML)]
• ↓
• [Code Generation Engine]
• ↓
• [Generated Code & Schemas]
Important Details
a) Input Processing:
• Support for both JSON and XML inputs
• JSON Schema extension handling
• Reference resolution system
b) Transform Engine:
• Transform operations processor
• Validation flow
• Instance transformation process
c) Code Generation:
• Parallel outputs for different formats (Avro, MessagePack, GraphQL)
• Go struct generation flow
• Serialization code generation
Additional Elements
• Version/metadata information
• External dependencies (Go modules)
• Test data flow
Technical Notes
• Validation checkpoints
Implementation Details
• Main entry points (main.go)
• Configuration points
• Test coverage paths
• Error handling flows
This design should reflect the tool's nature as both a library and a code generation utility, with clear separation between transform operations and code generation capabilities.