refs(py): standard tests (#1265)

mdrxy · Copilot · web-flow · commit e9d192151bf7 · 2025-11-03T23:28:45.000-05:00
improve org

---------

Co-authored-by: Copilot &lt;175728472+Copilot@users.noreply.github.com&gt;
diff --git a/reference/python/docs/langchain_tests/index.md b/reference/python/docs/langchain_tests/index.md
@@ -20,14 +20,14 @@ To learn how to use these, see the [guide on integrating standard tests](https:/
 
     Test components in isolation and without access to external services.
 
-    [:octicons-arrow-right-24: Reference](./unit_tests.md)
+    [:octicons-arrow-right-24: Reference](./unit_tests/index.md)
 
 - :material-lan-connect:{ .lg .middle } __Integration tests__
 
     ---
 
     Test components in combination with external services to ensure end-to-end functionality.
 
-    [:octicons-arrow-right-24: Reference](./integration_tests.md)
+    [:octicons-arrow-right-24: Reference](./integration_tests/index.md)
 
 </div>
diff --git a/reference/python/docs/langchain_tests/integration_tests.md b/reference/python/docs/langchain_tests/integration_tests.md
diff --git a/reference/python/docs/langchain_tests/integration_tests/base.md b/reference/python/docs/langchain_tests/integration_tests/base.md
@@ -0,0 +1,6 @@
+# Base tests
+
+::: langchain_tests.unit_tests.chat_models.ChatModelTests
+::: langchain_tests.unit_tests.embeddings.EmbeddingsTests
+::: langchain_tests.unit_tests.tools.ToolsTests
+::: langchain_tests.base.BaseStandardTests
diff --git a/reference/python/docs/langchain_tests/integration_tests/caches.md b/reference/python/docs/langchain_tests/integration_tests/caches.md
@@ -0,0 +1,4 @@
+# Cache integration tests
+
+::: langchain_tests.integration_tests.SyncCacheTestSuite
+::: langchain_tests.integration_tests.AsyncCacheTestSuite
diff --git a/reference/python/docs/langchain_tests/integration_tests/chat_models.md b/reference/python/docs/langchain_tests/integration_tests/chat_models.md
@@ -0,0 +1,3 @@
+# Chat model integration tests
+
+::: langchain_tests.integration_tests.ChatModelIntegrationTests
diff --git a/reference/python/docs/langchain_tests/integration_tests/embeddings.md b/reference/python/docs/langchain_tests/integration_tests/embeddings.md
@@ -0,0 +1,3 @@
+# Embeddings integration tests
+
+::: langchain_tests.integration_tests.EmbeddingsIntegrationTests
diff --git a/reference/python/docs/langchain_tests/integration_tests/index.md b/reference/python/docs/langchain_tests/integration_tests/index.md
@@ -0,0 +1,15 @@
+# Integration tests
+
+Integration tests for LangChain components help ensure that your implementations work correctly with the LangChain ecosystem.
+
+- [Chat models](./chat_models.md)
+- [Embeddings](./embeddings.md)
+- [Retrievers](./retrievers.md)
+- [Tools](./tools.md)
+- [Vector stores](./vectorstores.md)
+- [Key-value store tests](./kv_stores.md)
+- [Cache tests](./caches.md)
+- [Base classes](./base.md)
+
+!!! tip "Docs"
+    See more details in the [standard tests documentation](https://docs.langchain.com/oss/python/contributing/standard-tests-langchain).
diff --git a/reference/python/docs/langchain_tests/integration_tests/kv_stores.md b/reference/python/docs/langchain_tests/integration_tests/kv_stores.md
@@ -0,0 +1,4 @@
+# Key-value store integration tests
+
+::: langchain_tests.integration_tests.BaseStoreSyncTests
+::: langchain_tests.integration_tests.BaseStoreAsyncTests
diff --git a/reference/python/docs/langchain_tests/integration_tests/retrievers.md b/reference/python/docs/langchain_tests/integration_tests/retrievers.md
@@ -0,0 +1,3 @@
+# Retriever integration tests
+
+::: langchain_tests.integration_tests.RetrieversIntegrationTests
diff --git a/reference/python/docs/langchain_tests/integration_tests/tools.md b/reference/python/docs/langchain_tests/integration_tests/tools.md
@@ -0,0 +1,3 @@
+# Tool integration tests
+
+::: langchain_tests.integration_tests.ToolsIntegrationTests
diff --git a/reference/python/docs/langchain_tests/integration_tests/vectorstores.md b/reference/python/docs/langchain_tests/integration_tests/vectorstores.md
@@ -0,0 +1,3 @@
+# Vector store integration tests
+
+::: langchain_tests.integration_tests.VectorStoreIntegrationTests
diff --git a/reference/python/docs/langchain_tests/unit_tests.md b/reference/python/docs/langchain_tests/unit_tests.md
diff --git a/reference/python/docs/langchain_tests/unit_tests/chat_models.md b/reference/python/docs/langchain_tests/unit_tests/chat_models.md
@@ -0,0 +1,3 @@
+# Chat model unit tests
+
+::: langchain_tests.unit_tests.ChatModelUnitTests
diff --git a/reference/python/docs/langchain_tests/unit_tests/embeddings.md b/reference/python/docs/langchain_tests/unit_tests/embeddings.md
@@ -0,0 +1,3 @@
+# Embeddings unit tests
+
+::: langchain_tests.unit_tests.EmbeddingsUnitTests
diff --git a/reference/python/docs/langchain_tests/unit_tests/index.md b/reference/python/docs/langchain_tests/unit_tests/index.md
@@ -0,0 +1,10 @@
+# Unit tests
+
+Unit tests for LangChain components help ensure that your implementations are correct without requiring external services.
+
+- [Chat models](./chat_models.md)
+- [Embeddings](./embeddings.md)
+- [Tools](./tools.md)
+
+!!! tip "Docs"
+    See more details in the [standard tests documentation](https://docs.langchain.com/oss/python/contributing/standard-tests-langchain).
diff --git a/reference/python/docs/langchain_tests/unit_tests/tools.md b/reference/python/docs/langchain_tests/unit_tests/tools.md
@@ -0,0 +1,3 @@
+# Tool unit tests
+
+::: langchain_tests.unit_tests.ToolsUnitTests
diff --git a/reference/python/mkdocs.yml b/reference/python/mkdocs.yml
@@ -378,8 +378,21 @@ nav:
       - Overview: langchain_mcp_adapters/index.md
     - langchain-tests:
       - langchain_tests/index.md
-      - Unit tests: langchain_tests/unit_tests.md
-      - Integration tests: langchain_tests/integration_tests.md
+      - Unit tests:
+        - langchain_tests/unit_tests/index.md
+        - Chat models: langchain_tests/unit_tests/chat_models.md
+        - Embeddings: langchain_tests/unit_tests/embeddings.md
+        - Tools: langchain_tests/unit_tests/tools.md
+      - Integration tests:
+        - langchain_tests/integration_tests/index.md
+        - Chat models: langchain_tests/integration_tests/chat_models.md
+        - Embeddings: langchain_tests/integration_tests/embeddings.md
+        - Retrievers: langchain_tests/integration_tests/retrievers.md
+        - Tools: langchain_tests/integration_tests/tools.md
+        - Vector stores: langchain_tests/integration_tests/vectorstores.md
+        - Key-value stores: langchain_tests/integration_tests/kv_stores.md
+        - Caches: langchain_tests/integration_tests/caches.md
+        - Base: langchain_tests/integration_tests/base.md
     - langchain-classic:
       - Overview: langchain_classic/index.md
       - Agents: langchain_classic/agents.md
diff --git a/reference/python/uv.lock b/reference/python/uv.lock

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Chat model integration tests`
	`2`	`+`
	`3`	`+::: langchain_tests.integration_tests.ChatModelIntegrationTests`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Embeddings integration tests`
	`2`	`+`
	`3`	`+::: langchain_tests.integration_tests.EmbeddingsIntegrationTests`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Retriever integration tests`
	`2`	`+`
	`3`	`+::: langchain_tests.integration_tests.RetrieversIntegrationTests`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# Tool integration tests`
	`2`	`+`
	`3`	`+::: langchain_tests.integration_tests.ToolsIntegrationTests`