trustgraph/trustgraph-cli/trustgraph/cli/load_knowledge.py

"""
Loads triples and entity contexts into the knowledge graph.
"""

import argparse
import os
import time
import rdflib
from typing import Iterator, Tuple

from trustgraph.api import Api, Triple
from trustgraph.log_level import LogLevel

default_url = os.getenv("TRUSTGRAPH_URL", 'http://localhost:8088/')
default_token = os.getenv("TRUSTGRAPH_TOKEN", None)
default_user = 'trustgraph'
default_collection = 'default'

class KnowledgeLoader:

    def __init__(
            self,
            files,
            flow,
            user,
            collection,
            document_id,
            url=default_url,
            token=None,
    ):
        self.files = files
        self.flow = flow
        self.user = user
        self.collection = collection
        self.document_id = document_id
        self.url = url
        self.token = token

    def load_triples_from_file(self, file) -> Iterator[Triple]:
        """Generator that yields Triple objects from a Turtle file"""

        g = rdflib.Graph()
        g.parse(file, format="turtle")

        for e in g:
            # Extract subject, predicate, object
            s_value = str(e[0])
            p_value = str(e[1])

            # Check if object is a URI or literal
            if isinstance(e[2], rdflib.term.URIRef):
                o_value = str(e[2])
                o_is_uri = True
            else:
                o_value = str(e[2])
                o_is_uri = False

            # Create Triple object
            # Note: The Triple dataclass has 's', 'p', 'o' fields as strings
            # The API will handle the metadata wrapping
            yield Triple(s=s_value, p=p_value, o=o_value)

    def load_entity_contexts_from_file(self, file) -> Iterator[Tuple[str, str]]:
        """Generator that yields (entity, context) tuples from a Turtle file"""

        g = rdflib.Graph()
        g.parse(file, format="turtle")

        for s, p, o in g:
            # If object is a URI, skip (we only want literal contexts)
            if isinstance(o, rdflib.term.URIRef):
                continue

            # If object is a literal, create entity context for subject
            s_str = str(s)
            o_str = str(o)

            yield (s_str, o_str)

    def run(self):
        """Load triples and entity contexts using Python API"""

        try:
            # Create API client
            api = Api(url=self.url, token=self.token)
            bulk = api.bulk()

            # Load triples from all files
            print("Loading triples...")
            total_triples = 0
            for file in self.files:
                print(f"  Processing {file}...")
                count = 0

                def counting_triples():
                    nonlocal count
                    for triple in self.load_triples_from_file(file):
                        count += 1
                        yield triple

                bulk.import_triples(
                    flow=self.flow,
                    triples=counting_triples(),
                    metadata={
                        "id": self.document_id,
                        "metadata": [],
                        "user": self.user,
                        "collection": self.collection
                    }
                )
                print(f"    Loaded {count} triples")
                total_triples += count

            print(f"Triples loaded. Total: {total_triples}")

            # Load entity contexts from all files
            print("Loading entity contexts...")
            total_contexts = 0
            for file in self.files:
                print(f"  Processing {file}...")
                count = 0

                # Convert tuples to the format expected by import_entity_contexts
                # Entity must be in Term format: {"t": "i", "i": uri} for IRI
                def entity_context_generator():
                    nonlocal count
                    for entity, context in self.load_entity_contexts_from_file(file):
                        count += 1
                        # Entities from RDF are URIs, use IRI term format
                        yield {
                            "entity": {"t": "i", "i": entity},
                            "context": context
                        }

                bulk.import_entity_contexts(
                    flow=self.flow,
                    contexts=entity_context_generator(),
                    metadata={
                        "id": self.document_id,
                        "metadata": [],
                        "user": self.user,
                        "collection": self.collection
                    }
                )
                print(f"    Loaded {count} entity contexts")
                total_contexts += count

            print(f"Entity contexts loaded. Total: {total_contexts}")

        except Exception as e:
            print(f"Error: {e}", flush=True)
            raise

def main():

    parser = argparse.ArgumentParser(
        prog='tg-load-knowledge',
        description=__doc__,
    )

    parser.add_argument(
        '-u', '--api-url',
        default=default_url,
        help=f'API URL (default: {default_url})',
    )

    parser.add_argument(
        '-t', '--token',
        default=default_token,
        help='Authentication token (default: $TRUSTGRAPH_TOKEN)',
    )

    parser.add_argument(
        '-i', '--document-id',
        required=True,
        help=f'Document ID)',
    )

    parser.add_argument(
        '-f', '--flow-id',
        default="default",
        help=f'Flow ID (default: default)'
    )

    parser.add_argument(
        '-U', '--user',
        default=default_user,
        help=f'User ID (default: {default_user})'
    )

    parser.add_argument(
        '-C', '--collection',
        default=default_collection,
        help=f'Collection ID (default: {default_collection})'
    )

    parser.add_argument(
        'files', nargs='+',
        help=f'Turtle files to load'
    )

    args = parser.parse_args()

    while True:

        try:
            loader = KnowledgeLoader(
                document_id=args.document_id,
                url=args.api_url,
                token=args.token,
                flow=args.flow_id,
                files=args.files,
                user=args.user,
                collection=args.collection,
            )

            loader.run()

            print("Triples and entity contexts loaded.")
            break

        except Exception as e:

            print("Exception:", e, flush=True)
            print("Will retry...", flush=True)

        time.sleep(10)

if __name__ == "__main__":
    main()