Skip to main content
`Ctrl`+`K`

#

# Source code for langchain.document_loaders.csv_loader

    from csv import DictReader
    from typing import Dict, List, Optional

    from langchain.docstore.document import Document
    from langchain.document_loaders.base import BaseLoader

    class CSVLoader(BaseLoader):
        """Loads a CSV file into a list of documents.

        Each document represents one row of the CSV file. Every row is converted into a
        key/value pair and outputted to a new line in the document's page_content.

        The source for each document loaded from csv is set to the value of the
        `file_path` argument for all doucments by default.
        You can override this by setting the `source_column` argument to the
        name of a column in the CSV file.
        The source of each document will then be set to the value of the column
        with the name specified in `source_column`.

        Output Example:
            .. code-block:: txt

                column1: value1
                column2: value2
                column3: value3
        """

        def __init__(
            self,
            file_path: str,
            source_column: Optional[str] = None,
            csv_args: Optional[Dict] = None,
            encoding: Optional[str] = None,
        ):
            self.file_path = file_path
            self.source_column = source_column
            self.encoding = encoding
            if csv_args is None:
                self.csv_args = {
                    "delimiter": ",",
                    "quotechar": '"',
                }
            else:
                self.csv_args = csv_args

        def load(self) -> List[Document]:
            docs = []

            with open(self.file_path, newline="", encoding=self.encoding) as csvfile:
                csv = DictReader(csvfile, **self.csv_args)  # type: ignore
                for i, row in enumerate(csv):
                    content = "\n".join(f"{k.strip()}: {v.strip()}" for k, v in row.items())
                    if self.source_column is not None:
                        source = row[self.source_column]
                    else:
                        source = self.file_path
                    metadata = {"source": source, "row": i}
                    doc = Document(page_content=content, metadata=metadata)
                    docs.append(doc)

            return docs