update readme

Author: sentrivana

.github/workflows/test-integrations-ai.yml

@@ -62,10 +62,6 @@ jobs:
         run: |
           set -x # print commands that are executed
           ./scripts/runtox.sh "py${{ matrix.python-version }}-langchain-latest"
-      - name: Test langchain-notiktoken latest
-        run: |
-          set -x # print commands that are executed
-          ./scripts/runtox.sh "py${{ matrix.python-version }}-langchain-notiktoken-latest"
       - name: Test openai latest
         run: |
           set -x # print commands that are executed
@@ -141,10 +137,6 @@ jobs:
         run: |
           set -x # print commands that are executed
           ./scripts/runtox.sh --exclude-latest "py${{ matrix.python-version }}-langchain"
-      - name: Test langchain-notiktoken pinned
-        run: |
-          set -x # print commands that are executed
-          ./scripts/runtox.sh --exclude-latest "py${{ matrix.python-version }}-langchain-notiktoken"
       - name: Test openai pinned
         run: |
           set -x # print commands that are executed

scripts/populate_tox/README.md

@@ -46,6 +46,7 @@ integration_name: {
      },
      "python": python_version_specifier,
      "include": package_version_specifier,
+     "variants": another_integration_name,
 }
 ```
 
@@ -153,6 +154,28 @@ be expressed like so:
 }
 ```
 
+### `variants`
+
+Sometimes we want to test a single integration against two different sets of
+dependencies. For example, `langchain` should be tested both with and without
+`tiktoken`. In that case, add the variant as its own entry in `TEST_SUITE_CONFIG`
+and link it from the base variant by referencing its name in `variants` of the
+original variant:
+
+```python
+{
+    "langchain": {
+        "variants": ["langchain-notiktoken"],
+        ...
+    },
+    "langchain-notiktoken": {
+        ...
+    }
+}
+```
+
+This will result in both `langchain` and `langchain-notiktoken` being run under
+the Langchain CI workflow.
 
 ## How-Tos
 

scripts/populate_tox/config.py

@@ -146,6 +146,7 @@
             "<0.2": ["httpx<0.28.0", "openai~=1.0.0"],
             ">0.2": ["langchain-community"],
         },
+        "variants": ["langchain-notiktoken"],
     },
     "langchain-notiktoken": {
         "package": "langchain",

scripts/populate_tox/populate_tox.py

@@ -646,6 +646,17 @@ def main(fail_on_changes: bool = False) -> None:
                     }
                 )
 
+                variants = TEST_SUITE_CONFIG[integration].get("variants") or []
+                for variant in variants:
+                    packages[group].append(
+                        {
+                            "name": variant,
+                            "package": package,
+                            "extra": extra,
+                            "releases": test_releases,
+                        }
+                    )
+
     if fail_on_changes:
         old_file_hash = get_file_hash()
 

scripts/split_tox_gh_actions/split_tox_gh_actions.py

@@ -58,7 +58,6 @@
         "anthropic",
         "cohere",
         "langchain",
-        "langchain-notiktoken",
         "openai",
         "huggingface_hub",
     ],

tox.ini

@@ -10,7 +10,7 @@
 # The file (and all resulting CI YAMLs) then need to be regenerated via
 # "scripts/generate-test-files.sh".
 #
-# Last generated: 2025-05-06T10:28:08.299635+00:00
+# Last generated: 2025-05-06T10:37:25.618827+00:00
 
 [tox]
 requires =