extension_registry.h

Go to the documentation of this file.

 
#ifndef EXTENSION_REGISTRY_H
#define EXTENSION_REGISTRY_H
 
#include <stdbool.h>
#include <stdint.h>
#include <stddef.h>
 
/* ------------------------------------------------------------------ */
/*  Forward declarations                                               */
/* ------------------------------------------------------------------ */
 
struct ParserSnapshot;
struct GrammarModification;
 
/* ------------------------------------------------------------------ */
/* ------------------------------------------------------------------ */
 
typedef enum DisambiguationStrategy {
    DISAMBIG_PRIORITY = 0,    
    DISAMBIG_FORK_RESOLVE,    
    DISAMBIG_ORACLE,          
    DISAMBIG_CONTEXT,         
    DISAMBIG_NONE,            
} DisambiguationStrategy;
 
 
/* ------------------------------------------------------------------ */
/* ------------------------------------------------------------------ */
 
typedef enum ExecutionPolicy {
    EXEC_SEQUENTIAL = 0,      
    EXEC_PARALLEL,            
    EXEC_PIPELINE,            
    EXEC_LAZY,                
} ExecutionPolicy;
 
 
/* ------------------------------------------------------------------ */
/* ------------------------------------------------------------------ */
 
typedef struct OracleContext {
    const char *extension_name;         
    const char *conflict_description;   
    int candidate_count;                
    const char **candidate_labels;      
    void *user_data;                    
} OracleContext;
 
typedef int (*OracleCallback)(const OracleContext *ctx);
 
 
/* ------------------------------------------------------------------ */
/* ------------------------------------------------------------------ */
 
typedef struct GrammarExtensionMetadata {
    const char *name;                   
    const char *version;                
    DisambiguationStrategy strategy;    
    int priority;                       
    ExecutionPolicy policy;             
    OracleCallback oracle;              
    float conflict_threshold;
 
    const char **requires;
 
    const char **conflicts_with;
 
    struct GrammarModification *modifications;
 
    uint32_t nmodifications;
} GrammarExtensionMetadata;
 
 
/* ------------------------------------------------------------------ */
/* ------------------------------------------------------------------ */
 
typedef struct ExtensionRegistry ExtensionRegistry;
 
 
/* ------------------------------------------------------------------ */
/* ------------------------------------------------------------------ */
 
typedef struct ExtensionOrder {
    char **names;               
    uint32_t count;             
} ExtensionOrder;
 
void extension_order_destroy(ExtensionOrder *order);
 
 
/* ------------------------------------------------------------------ */
/* ------------------------------------------------------------------ */
 
ExtensionRegistry *extension_registry_create(void);
 
bool extension_registry_register(ExtensionRegistry *reg,
                                 const GrammarExtensionMetadata *metadata);
 
const GrammarExtensionMetadata *extension_registry_find(
    ExtensionRegistry *reg,
    const char *name);
 
bool extension_registry_check_dependencies(ExtensionRegistry *reg,
                                           char **error_out);
 
bool extension_registry_get_order(ExtensionRegistry *reg,
                                  ExtensionOrder *order_out,
                                  char **error_out);
 
bool extension_registry_unregister(ExtensionRegistry *reg,
                                   const char *name);
 
uint32_t extension_registry_count(const ExtensionRegistry *reg);
 
typedef bool (*ExtensionVisitorFn)(const GrammarExtensionMetadata *meta,
                                   void *user_data);
 
void extension_registry_foreach(const ExtensionRegistry *reg,
                                ExtensionVisitorFn visitor,
                                void *user_data);
 
void extension_registry_destroy(ExtensionRegistry *reg);
 
 
#endif /* EXTENSION_REGISTRY_H */