Add better error messages for from_texts and from_documents

pinecone/control/langchain_import_warnings.py

@@ -0,0 +1,8 @@
+from pinecone.utils import docslinks
+
+KB_ARTICLE = docslinks['LANGCHAIN_IMPORT_KB_ARTICLE']
+
+def _build_langchain_attribute_error_message(method_name: str):
+    return f"""{method_name} is not a top-level attribute of the Pinecone class provided by pinecone's official python package developed at https://github.com/pinecone-io/pinecone-python-client. You may have a name collision with an export from another dependency in your project that wraps Pinecone functionality and exports a similarly named class. Please refer to the following knowledge base article for more information: {KB_ARTICLE}
+"""
+

pinecone/control/pinecone.py

@@ -16,6 +16,7 @@
     ConfigureIndexRequestSpecPod
 )
 from pinecone.models import ServerlessSpec, PodSpec, IndexList, CollectionList
+from .langchain_import_warnings import _build_langchain_attribute_error_message
 
 from pinecone.data import Index
 
@@ -545,6 +546,13 @@ def _get_status(self, name: str):
         response = api_instance.describe_index(name)
         return response["status"]
 
+    @staticmethod
+    def from_texts(*args, **kwargs):
+        raise AttributeError(_build_langchain_attribute_error_message("from_texts"))
+
+    @staticmethod
+    def from_documents(*args, **kwargs):
+        raise AttributeError(_build_langchain_attribute_error_message("from_documents"))
 
     def Index(self, name: str = '', host: str = '', **kwargs):
         """

pinecone/utils/__init__.py

@@ -5,4 +5,5 @@
 from .fix_tuple_length import fix_tuple_length
 from .convert_to_list import convert_to_list
 from .normalize_host import normalize_host
-from .setup_openapi_client import setup_openapi_client
+from .setup_openapi_client import setup_openapi_client
+from .docslinks import docslinks

pinecone/utils/docslinks.py

@@ -0,0 +1,3 @@
+docslinks = {
+    'LANGCHAIN_IMPORT_KB_ARTICLE': "https://docs.pinecone.io/troubleshooting/pinecone-attribute-errors-with-langchain"
+}

tests/unit/test_langchain_helpful_errors.py

@@ -0,0 +1,19 @@
+import pytest
+from pinecone import Pinecone
+
+class TestLangchainErrorMessages():
+    def test_error_from_texts_positional_args(self):
+        with pytest.raises(AttributeError) as e:
+            Pinecone.from_texts("texts", "id")
+        assert "from_texts is not a top-level attribute of the Pinecone class" in str(e.value)
+
+    def test_error_from_texts_kwargs(self):
+        with pytest.raises(AttributeError) as e:
+            Pinecone.from_texts(foo="texts", bar="id", num_threads=1)
+        assert "from_texts is not a top-level attribute of the Pinecone class" in str(e.value)
+
+    def test_error_from_documents(self):
+        with pytest.raises(AttributeError) as e:
+            Pinecone.from_documents("documents", "id")
+        assert "from_documents is not a top-level attribute of the Pinecone class" in str(e.value)
+

tests/unit/utils/test_docs_links.py

@@ -0,0 +1,10 @@
+import pytest
+import requests
+from pinecone.utils import docslinks
+
+urls = list(docslinks.values())
+
+@pytest.mark.parametrize("url", urls)
+def test_valid_links(url):
+        response = requests.get(url)
+        assert response.status_code == 200, f"Docs link is invalid: {url}"