NCTokenEnricher.scala

/*
 * Licensed to the Apache Software Foundation (ASF) under one or more
 * contributor license agreements.  See the NOTICE file distributed with
 * this work for additional information regarding copyright ownership.
 * The ASF licenses this file to You under the Apache License, Version 2.0
 * (the "License"); you may not use this file except in compliance with
 * the License.  You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.apache.nlpcraft

/**
  * Optional pipeline component that can enrich previously parsed [[NCToken tokens]].
  * See [[NCPipeline]] for documentation on the token enricher place in the overall processing pipeline.
  *
  * @see [[NCPipeline.getTokenEnrichers]]
  * @see [[NCEntity]]
  * @see [[NCToken]]
  * @see [[NCTokenParser]]
  * @see [[NCTokenValidator]]
  * @see [[NCEntityParser]]
  * @see [[NCEntityEnricher]]
  * @see [[NCEntityValidator]]
  * @see [[NCEntityMapper]]
  */
//noinspection DuplicatedCode
trait NCTokenEnricher extends NCLifecycle:
    /**
      * Enriches, or otherwise modifies, previously parsed [[NCToken tokens]].
      *
      * @param req Original request.
      * @param cfg Model configuration.
      * @param toks Previously parsed tokens to enrich.
      */
    def enrich(req: NCRequest, cfg: NCModelConfig, toks: List[NCToken]): Unit