chore: move DocumentJoiner to new joiners package

e2e/pipelines/test_dense_doc_search.py

@@ -4,7 +4,8 @@
 from haystack.components.embedders import SentenceTransformersDocumentEmbedder, SentenceTransformersTextEmbedder
 from haystack.components.converters import PyPDFToDocument, TextFileToDocument
 from haystack.components.preprocessors import DocumentCleaner, DocumentSplitter
-from haystack.components.routers import FileTypeRouter, DocumentJoiner
+from haystack.components.routers import FileTypeRouter
+from haystack.components.joiners import DocumentJoiner
 from haystack.components.writers import DocumentWriter
 from haystack.document_stores import InMemoryDocumentStore
 from haystack.components.retrievers import InMemoryEmbeddingRetriever

e2e/pipelines/test_eval_dense_doc_search.py

@@ -3,7 +3,8 @@
 from haystack.components.embedders import SentenceTransformersDocumentEmbedder, SentenceTransformersTextEmbedder
 from haystack.components.preprocessors import DocumentCleaner, DocumentSplitter
 from haystack.components.retrievers import InMemoryEmbeddingRetriever
-from haystack.components.routers import DocumentJoiner, FileTypeRouter
+from haystack.components.routers import FileTypeRouter
+from haystack.components.joiners import DocumentJoiner
 from haystack.components.writers import DocumentWriter
 from haystack.dataclasses import Document
 from haystack.document_stores import InMemoryDocumentStore

e2e/pipelines/test_eval_hybrid_doc_search_pipeline.py

@@ -2,7 +2,7 @@
 from haystack.components.embedders import SentenceTransformersTextEmbedder
 from haystack.components.rankers import TransformersSimilarityRanker
 from haystack.components.retrievers import InMemoryBM25Retriever, InMemoryEmbeddingRetriever
-from haystack.components.routers.document_joiner import DocumentJoiner
+from haystack.components.joiners.document_joiner import DocumentJoiner
 from haystack.document_stores import InMemoryDocumentStore
 from haystack.evaluation.eval import eval
 

e2e/pipelines/test_hybrid_doc_search_pipeline.py

@@ -3,7 +3,7 @@
 from haystack import Pipeline, Document
 from haystack.components.embedders import SentenceTransformersTextEmbedder
 from haystack.components.rankers import TransformersSimilarityRanker
-from haystack.components.routers.document_joiner import DocumentJoiner
+from haystack.components.joiners.document_joiner import DocumentJoiner
 from haystack.document_stores import InMemoryDocumentStore
 from haystack.components.retrievers import InMemoryBM25Retriever, InMemoryEmbeddingRetriever
 

examples/pipelines/indexing_pipeline.py

@@ -4,7 +4,8 @@
 from haystack.components.embedders import SentenceTransformersDocumentEmbedder
 from haystack.components.converters import PyPDFToDocument, TextFileToDocument
 from haystack.components.preprocessors import DocumentCleaner, DocumentSplitter
-from haystack.components.routers import FileTypeRouter, DocumentJoiner
+from haystack.components.routers import FileTypeRouter
+from haystack.components.joiners import DocumentJoiner
 from haystack.components.writers import DocumentWriter
 from haystack.document_stores import InMemoryDocumentStore
 

haystack/components/joiners/__init__.py

@@ -0,0 +1,3 @@
+from haystack.components.joiners.document_joiner import DocumentJoiner
+
+__all__ = ["DocumentJoiner"]

haystack/components/routers/__init__.py

@@ -1,7 +1,6 @@
-from haystack.components.routers.document_joiner import DocumentJoiner
 from haystack.components.routers.file_type_router import FileTypeRouter
 from haystack.components.routers.metadata_router import MetadataRouter
 from haystack.components.routers.conditional_router import ConditionalRouter
 from haystack.components.routers.text_language_router import TextLanguageRouter
 
-__all__ = ["DocumentJoiner", "FileTypeRouter", "MetadataRouter", "TextLanguageRouter", "ConditionalRouter"]
+__all__ = ["FileTypeRouter", "MetadataRouter", "TextLanguageRouter", "ConditionalRouter"]

haystack/pipeline_utils/indexing.py

@@ -11,7 +11,8 @@
 from haystack.components.embedders import SentenceTransformersDocumentEmbedder, OpenAIDocumentEmbedder
 from haystack.components.fetchers import LinkContentFetcher
 from haystack.components.preprocessors import DocumentCleaner, DocumentSplitter
-from haystack.components.routers import FileTypeRouter, DocumentJoiner
+from haystack.components.routers import FileTypeRouter
+from haystack.components.joiners import DocumentJoiner
 from haystack.components.writers import DocumentWriter
 from haystack.document_stores.protocol import DocumentStore
 

releasenotes/notes/move-documentjoiner-to-joiners-7fe188d18d65ffcd.yaml

@@ -0,0 +1,10 @@
+---
+upgrade:
+  - |
+    Change any occurrence of:
+        from haystack.components.routers.document_joiner import DocumentJoiner
+    to:
+        from haystack.components.joiners.document_joiner import DocumentJoiner
+enhancements:
+  - |
+    Create a new package called `joiners` and move `DocumentJoiner` there for clarity.

test/components/routers/test_document_joiner.py → test/components/joiners/test_document_joiner.py

@@ -3,7 +3,7 @@
 import pytest
 
 from haystack import Document
-from haystack.components.routers.document_joiner import DocumentJoiner
+from haystack.components.joiners.document_joiner import DocumentJoiner
 
 
 class TestDocumentJoiner: