# Copyright (c) "Neo4j"
# Neo4j Sweden AB [https://neo4j.com]
# #
# Licensed 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.
"""Document loaders: base class, PDF, Markdown, and extension-based file dispatch."""
from __future__ import annotations
import io
from abc import abstractmethod
from pathlib import Path
from typing import Dict, Optional, Union, cast
import fsspec
import pypdf
from fsspec import AbstractFileSystem
from fsspec.implementations.local import LocalFileSystem
from neo4j_graphrag.exceptions import MarkdownLoadError, PdfLoaderError
from neo4j_graphrag.experimental.components.types import (
DocumentInfo,
DocumentType,
LoadedDocument,
)
from neo4j_graphrag.experimental.pipeline.component import Component
def is_default_fs(fs: fsspec.AbstractFileSystem) -> bool:
return isinstance(fs, LocalFileSystem) and not fs.auto_mkdir
[docs]
class DataLoader(Component):
"""
Interface for loading data of various input types.
"""
[docs]
@abstractmethod
async def run(
self,
filepath: Union[str, Path],
metadata: Optional[Dict[str, str]] = None,
) -> LoadedDocument: ...
[docs]
class PdfLoader(DataLoader):
"""Loads text from PDF files using pypdf."""
[docs]
@staticmethod
def load_file(
file: str,
fs: AbstractFileSystem,
) -> str:
"""Parse a PDF file and return extracted text."""
try:
with fs.open(file, "rb") as fp:
stream = fp if is_default_fs(fs) else io.BytesIO(fp.read())
pdf = pypdf.PdfReader(stream)
num_pages = len(pdf.pages)
text_parts = (
pdf.pages[page].extract_text() for page in range(num_pages)
)
return "\n".join(text_parts)
except Exception as e:
raise PdfLoaderError(e)
[docs]
async def run(
self,
filepath: Union[str, Path],
metadata: Optional[Dict[str, str]] = None,
fs: Optional[Union[AbstractFileSystem, str]] = None,
) -> LoadedDocument:
if not isinstance(filepath, str):
filepath = str(filepath)
if isinstance(fs, str):
fs = fsspec.filesystem(fs)
elif fs is None:
fs = LocalFileSystem()
text = self.load_file(filepath, fs)
return LoadedDocument(
text=text,
document_info=DocumentInfo(
path=filepath,
metadata=self.get_document_metadata(text, metadata),
document_type=DocumentType.PDF,
),
)
[docs]
class MarkdownLoader(DataLoader):
"""Loads UTF-8 Markdown (``.md`` / ``.markdown``) files as plain text."""
[docs]
@staticmethod
def load_file(
file: str,
fs: AbstractFileSystem,
) -> str:
try:
with fs.open(file, "rb") as fp:
raw = fp.read()
return cast(str, raw.decode("utf-8"))
except Exception as e:
raise MarkdownLoadError(e)
[docs]
async def run(
self,
filepath: Union[str, Path],
metadata: Optional[Dict[str, str]] = None,
fs: Optional[Union[AbstractFileSystem, str]] = None,
) -> LoadedDocument:
if not isinstance(filepath, str):
filepath = str(filepath)
if isinstance(fs, str):
fs = fsspec.filesystem(fs)
elif fs is None:
fs = LocalFileSystem()
text = MarkdownLoader.load_file(filepath, fs)
return LoadedDocument(
text=text,
document_info=DocumentInfo(
path=filepath,
metadata=self.get_document_metadata(text, metadata),
document_type=DocumentType.MARKDOWN,
),
)