Struct KnowledgeImporter 

pub struct KnowledgeImporter;

Knowledge importer for parsing Knowledge Base article YAML files

Implementations

impl KnowledgeImporter

pub fn new() -> Self

Create a new Knowledge importer instance

pub fn import( &self, yaml_content: &str, ) -> Result<KnowledgeArticle, ImportError>

Import a knowledge article from YAML content

Optionally validates against the JSON schema if the schema-validation feature is enabled.

Arguments

• yaml_content - Knowledge article YAML content as a string

Returns

A KnowledgeArticle parsed from the YAML content

Example

use data_modelling_core::import::knowledge::KnowledgeImporter;

let importer = KnowledgeImporter::new();
let yaml = r#"
id: 660e8400-e29b-41d4-a716-446655440000
number: 1
title: "Data Classification Guide"
articleType: guide
status: published
summary: "This guide explains data classification."
content: "Data classification is essential for governance."
authors:
  - "data-governance@example.com"
createdAt: "2024-01-15T10:00:00Z"
updatedAt: "2024-01-15T10:00:00Z"
"#;
let article = importer.import(yaml).unwrap();
assert_eq!(article.title, "Data Classification Guide");

pub fn import_without_validation( &self, yaml_content: &str, ) -> Result<KnowledgeArticle, ImportError>

Import a knowledge article without schema validation

Use this when you want to skip schema validation for performance or when importing from a trusted source.

Arguments

• yaml_content - Knowledge article YAML content as a string

Returns

A KnowledgeArticle parsed from the YAML content

pub fn import_index( &self, yaml_content: &str, ) -> Result<KnowledgeIndex, ImportError>

Import a knowledge index from YAML content

Arguments

• yaml_content - Knowledge index YAML content (knowledge.yaml)

Returns

A KnowledgeIndex parsed from the YAML content

Example

use data_modelling_core::import::knowledge::KnowledgeImporter;

let importer = KnowledgeImporter::new();
let yaml = r#"
schemaVersion: "1.0"
articles: []
nextNumber: 1
"#;
let index = importer.import_index(yaml).unwrap();
assert_eq!(index.next_number, 1);

pub fn import_from_directory( &self, dir_path: &Path, ) -> Result<(Vec<KnowledgeArticle>, Vec<ImportError>), ImportError>

Import multiple knowledge articles from a directory

Loads all .kb.yaml files from the specified directory.

Arguments

• dir_path - Path to the directory containing knowledge article files

Returns

A vector of parsed KnowledgeArticle objects and any import errors

pub fn import_by_domain( &self, dir_path: &Path, domain: &str, ) -> Result<(Vec<KnowledgeArticle>, Vec<ImportError>), ImportError>

Import articles filtered by domain

Arguments

• dir_path - Path to the directory containing knowledge article files
• domain - Domain to filter by

Returns

A vector of parsed KnowledgeArticle objects for the specified domain

Trait Implementations

impl Default for KnowledgeImporter

fn default() -> Self

Returns the “default value” for a type.