Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 1 | package config |
| 2 | |
| 3 | import ( |
| 4 | "fmt" |
| 5 | "os" |
| 6 | |
Akron | fa55bb2 | 2025-05-26 15:10:42 +0200 | [diff] [blame] | 7 | "github.com/KorAP/KoralPipe-TermMapper/ast" |
| 8 | "github.com/KorAP/KoralPipe-TermMapper/parser" |
Akron | 7e8da93 | 2025-07-01 11:56:46 +0200 | [diff] [blame] | 9 | "github.com/rs/zerolog/log" |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 10 | "gopkg.in/yaml.v3" |
| 11 | ) |
| 12 | |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 13 | const ( |
Akron | 2ac2ec0 | 2025-06-05 15:26:42 +0200 | [diff] [blame] | 14 | defaultServer = "https://korap.ids-mannheim.de/" |
| 15 | defaultSDK = "https://korap.ids-mannheim.de/js/korap-plugin-latest.js" |
| 16 | defaultServiceURL = "https://korap.ids-mannheim.de/plugin/termmapper" |
Akron | 14c13a5 | 2025-06-06 15:36:23 +0200 | [diff] [blame] | 17 | defaultPort = 5725 |
Akron | 2ac2ec0 | 2025-06-05 15:26:42 +0200 | [diff] [blame] | 18 | defaultLogLevel = "warn" |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 19 | ) |
| 20 | |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 21 | // MappingRule represents a single mapping rule in the configuration |
| 22 | type MappingRule string |
| 23 | |
| 24 | // MappingList represents a list of mapping rules with metadata |
| 25 | type MappingList struct { |
Akron | dab2711 | 2025-06-05 13:52:43 +0200 | [diff] [blame] | 26 | ID string `yaml:"id"` |
| 27 | Description string `yaml:"desc,omitempty"` |
| 28 | FoundryA string `yaml:"foundryA,omitempty"` |
| 29 | LayerA string `yaml:"layerA,omitempty"` |
| 30 | FoundryB string `yaml:"foundryB,omitempty"` |
| 31 | LayerB string `yaml:"layerB,omitempty"` |
| 32 | Mappings []MappingRule `yaml:"mappings"` |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 33 | } |
| 34 | |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 35 | // MappingConfig represents the root configuration containing multiple mapping lists |
| 36 | type MappingConfig struct { |
Akron | 2ac2ec0 | 2025-06-05 15:26:42 +0200 | [diff] [blame] | 37 | SDK string `yaml:"sdk,omitempty"` |
| 38 | Server string `yaml:"server,omitempty"` |
| 39 | ServiceURL string `yaml:"serviceURL,omitempty"` |
| 40 | Port int `yaml:"port,omitempty"` |
| 41 | LogLevel string `yaml:"loglevel,omitempty"` |
| 42 | Lists []MappingList `yaml:"lists,omitempty"` |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 43 | } |
| 44 | |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 45 | // LoadFromSources loads configuration from multiple sources and merges them: |
| 46 | // - A main configuration file (optional) containing global settings and lists |
| 47 | // - Individual mapping files (optional) containing single mapping lists each |
| 48 | // At least one source must be provided |
| 49 | func LoadFromSources(configFile string, mappingFiles []string) (*MappingConfig, error) { |
| 50 | var allLists []MappingList |
| 51 | var globalConfig MappingConfig |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 52 | |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 53 | // Track seen IDs across all sources to detect duplicates |
| 54 | seenIDs := make(map[string]bool) |
Akron | a5d8814 | 2025-05-22 14:42:09 +0200 | [diff] [blame] | 55 | |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 56 | // Load main configuration file if provided |
| 57 | if configFile != "" { |
| 58 | data, err := os.ReadFile(configFile) |
| 59 | if err != nil { |
| 60 | return nil, fmt.Errorf("failed to read config file '%s': %w", configFile, err) |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 61 | } |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 62 | |
| 63 | if len(data) == 0 { |
| 64 | return nil, fmt.Errorf("EOF: config file '%s' is empty", configFile) |
| 65 | } |
| 66 | |
| 67 | // Try to unmarshal as new format first (object with optional sdk/server and lists) |
Akron | 813780f | 2025-06-05 15:44:28 +0200 | [diff] [blame] | 68 | if err := yaml.Unmarshal(data, &globalConfig); err == nil { |
| 69 | // Successfully parsed as new format - accept it regardless of whether it has lists |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 70 | for _, list := range globalConfig.Lists { |
| 71 | if seenIDs[list.ID] { |
| 72 | return nil, fmt.Errorf("duplicate mapping list ID found: %s", list.ID) |
| 73 | } |
| 74 | seenIDs[list.ID] = true |
| 75 | } |
| 76 | allLists = append(allLists, globalConfig.Lists...) |
| 77 | } else { |
| 78 | // Fall back to old format (direct list) |
| 79 | var lists []MappingList |
| 80 | if err := yaml.Unmarshal(data, &lists); err != nil { |
| 81 | return nil, fmt.Errorf("failed to parse YAML config file '%s': %w", configFile, err) |
| 82 | } |
| 83 | |
| 84 | for _, list := range lists { |
| 85 | if seenIDs[list.ID] { |
| 86 | return nil, fmt.Errorf("duplicate mapping list ID found: %s", list.ID) |
| 87 | } |
| 88 | seenIDs[list.ID] = true |
| 89 | } |
| 90 | allLists = append(allLists, lists...) |
| 91 | // Clear the lists from globalConfig since we got them from the old format |
| 92 | globalConfig.Lists = nil |
| 93 | } |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 94 | } |
| 95 | |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 96 | // Load individual mapping files |
| 97 | for _, file := range mappingFiles { |
| 98 | data, err := os.ReadFile(file) |
| 99 | if err != nil { |
Akron | 7e8da93 | 2025-07-01 11:56:46 +0200 | [diff] [blame] | 100 | log.Error().Err(err).Str("file", file).Msg("Failed to read mapping file") |
| 101 | continue |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 102 | } |
| 103 | |
| 104 | if len(data) == 0 { |
Akron | 7e8da93 | 2025-07-01 11:56:46 +0200 | [diff] [blame] | 105 | log.Error().Err(err).Str("file", file).Msg("EOF: mapping file is empty") |
| 106 | continue |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 107 | } |
| 108 | |
| 109 | var list MappingList |
| 110 | if err := yaml.Unmarshal(data, &list); err != nil { |
Akron | 7e8da93 | 2025-07-01 11:56:46 +0200 | [diff] [blame] | 111 | log.Error().Err(err).Str("file", file).Msg("Failed to parse YAML mapping file") |
| 112 | continue |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 113 | } |
| 114 | |
| 115 | if seenIDs[list.ID] { |
Akron | 7e8da93 | 2025-07-01 11:56:46 +0200 | [diff] [blame] | 116 | log.Error().Err(err).Str("file", file).Str("list-id", list.ID).Msg("Duplicate mapping list ID found") |
| 117 | continue |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 118 | } |
| 119 | seenIDs[list.ID] = true |
| 120 | allLists = append(allLists, list) |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 121 | } |
| 122 | |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 123 | // Ensure we have at least some configuration |
| 124 | if len(allLists) == 0 { |
| 125 | return nil, fmt.Errorf("no mapping lists found: provide either a config file (-c) with lists or mapping files (-m)") |
| 126 | } |
| 127 | |
Akron | 585f50f | 2025-07-03 13:55:47 +0200 | [diff] [blame^] | 128 | // Validate all mapping lists (skip duplicate ID check since we already did it) |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 129 | if err := validateMappingLists(allLists); err != nil { |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 130 | return nil, err |
| 131 | } |
| 132 | |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 133 | // Create final configuration |
| 134 | result := &MappingConfig{ |
Akron | 2ac2ec0 | 2025-06-05 15:26:42 +0200 | [diff] [blame] | 135 | SDK: globalConfig.SDK, |
| 136 | Server: globalConfig.Server, |
| 137 | ServiceURL: globalConfig.ServiceURL, |
| 138 | Port: globalConfig.Port, |
| 139 | LogLevel: globalConfig.LogLevel, |
| 140 | Lists: allLists, |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 141 | } |
| 142 | |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 143 | // Apply defaults if not specified |
Akron | 2ac2ec0 | 2025-06-05 15:26:42 +0200 | [diff] [blame] | 144 | ApplyDefaults(result) |
Akron | e1cff7c | 2025-06-04 18:43:32 +0200 | [diff] [blame] | 145 | |
| 146 | return result, nil |
| 147 | } |
| 148 | |
Akron | 585f50f | 2025-07-03 13:55:47 +0200 | [diff] [blame^] | 149 | // ApplyDefaults sets default values for configuration fields if they are empty |
Akron | 2ac2ec0 | 2025-06-05 15:26:42 +0200 | [diff] [blame] | 150 | func ApplyDefaults(config *MappingConfig) { |
Akron | 585f50f | 2025-07-03 13:55:47 +0200 | [diff] [blame^] | 151 | defaults := map[*string]string{ |
| 152 | &config.SDK: defaultSDK, |
| 153 | &config.Server: defaultServer, |
| 154 | &config.ServiceURL: defaultServiceURL, |
| 155 | &config.LogLevel: defaultLogLevel, |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 156 | } |
Akron | 585f50f | 2025-07-03 13:55:47 +0200 | [diff] [blame^] | 157 | |
| 158 | for field, defaultValue := range defaults { |
| 159 | if *field == "" { |
| 160 | *field = defaultValue |
| 161 | } |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 162 | } |
Akron | 585f50f | 2025-07-03 13:55:47 +0200 | [diff] [blame^] | 163 | |
Akron | a8a66ce | 2025-06-05 10:50:17 +0200 | [diff] [blame] | 164 | if config.Port == 0 { |
| 165 | config.Port = defaultPort |
| 166 | } |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 167 | } |
| 168 | |
Akron | 585f50f | 2025-07-03 13:55:47 +0200 | [diff] [blame^] | 169 | // validateMappingLists validates a slice of mapping lists (without duplicate ID checking) |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 170 | func validateMappingLists(lists []MappingList) error { |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 171 | for i, list := range lists { |
| 172 | if list.ID == "" { |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 173 | return fmt.Errorf("mapping list at index %d is missing an ID", i) |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 174 | } |
Akron | a5d8814 | 2025-05-22 14:42:09 +0200 | [diff] [blame] | 175 | |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 176 | if len(list.Mappings) == 0 { |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 177 | return fmt.Errorf("mapping list '%s' has no mapping rules", list.ID) |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 178 | } |
| 179 | |
| 180 | // Validate each mapping rule |
| 181 | for j, rule := range list.Mappings { |
| 182 | if rule == "" { |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 183 | return fmt.Errorf("mapping list '%s' rule at index %d is empty", list.ID, j) |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 184 | } |
| 185 | } |
| 186 | } |
Akron | 06d21f0 | 2025-06-04 14:36:07 +0200 | [diff] [blame] | 187 | return nil |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 188 | } |
| 189 | |
| 190 | // ParseMappings parses all mapping rules in a list and returns a slice of parsed rules |
| 191 | func (list *MappingList) ParseMappings() ([]*parser.MappingResult, error) { |
| 192 | // Create a grammar parser with the list's default foundries and layers |
| 193 | grammarParser, err := parser.NewGrammarParser("", "") |
| 194 | if err != nil { |
| 195 | return nil, fmt.Errorf("failed to create grammar parser: %w", err) |
| 196 | } |
| 197 | |
| 198 | results := make([]*parser.MappingResult, len(list.Mappings)) |
| 199 | for i, rule := range list.Mappings { |
Akron | a5d8814 | 2025-05-22 14:42:09 +0200 | [diff] [blame] | 200 | // Check for empty rules first |
| 201 | if rule == "" { |
| 202 | return nil, fmt.Errorf("empty mapping rule at index %d in list '%s'", i, list.ID) |
| 203 | } |
| 204 | |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 205 | // Parse the mapping rule |
| 206 | result, err := grammarParser.ParseMapping(string(rule)) |
| 207 | if err != nil { |
| 208 | return nil, fmt.Errorf("failed to parse mapping rule %d in list '%s': %w", i, list.ID, err) |
| 209 | } |
| 210 | |
| 211 | // Apply default foundries and layers if not specified in the rule |
| 212 | if list.FoundryA != "" { |
| 213 | applyDefaultFoundryAndLayer(result.Upper.Wrap, list.FoundryA, list.LayerA) |
| 214 | } |
| 215 | if list.FoundryB != "" { |
| 216 | applyDefaultFoundryAndLayer(result.Lower.Wrap, list.FoundryB, list.LayerB) |
| 217 | } |
| 218 | |
| 219 | results[i] = result |
| 220 | } |
| 221 | |
| 222 | return results, nil |
| 223 | } |
| 224 | |
| 225 | // applyDefaultFoundryAndLayer recursively applies default foundry and layer to terms that don't have them specified |
| 226 | func applyDefaultFoundryAndLayer(node ast.Node, defaultFoundry, defaultLayer string) { |
| 227 | switch n := node.(type) { |
| 228 | case *ast.Term: |
Akron | 585f50f | 2025-07-03 13:55:47 +0200 | [diff] [blame^] | 229 | if n.Foundry == "" && defaultFoundry != "" { |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 230 | n.Foundry = defaultFoundry |
| 231 | } |
Akron | 585f50f | 2025-07-03 13:55:47 +0200 | [diff] [blame^] | 232 | if n.Layer == "" && defaultLayer != "" { |
Akron | 57ee558 | 2025-05-21 15:25:13 +0200 | [diff] [blame] | 233 | n.Layer = defaultLayer |
| 234 | } |
| 235 | case *ast.TermGroup: |
| 236 | for _, op := range n.Operands { |
| 237 | applyDefaultFoundryAndLayer(op, defaultFoundry, defaultLayer) |
| 238 | } |
| 239 | } |
| 240 | } |