test: add network mocking for example tests

- Add responses library for HTTP mocking

- Mock StackOne API calls in tests instead of skipping

- Import and execute examples directly to enable mocking

- Skip only when optional dependencies are missing

Author: ryoppippi

examples/test_examples.py

@@ -1,8 +1,11 @@
-import subprocess
+import importlib.util
+import os
 import sys
 from pathlib import Path
+from typing import Any
 
 import pytest
+import responses
 
 
 def get_example_files() -> list[str]:
@@ -21,19 +24,64 @@ def get_example_files() -> list[str]:
 
 EXAMPLES = get_example_files()
 
+# Map of example files to required optional packages
+OPTIONAL_DEPENDENCIES = {
+    "openai_integration.py": ["openai"],
+    "langchain_integration.py": ["langchain_openai"],
+    "crewai_integration.py": ["crewai"],
+}
 
-def test_example_files_exist():
+
+def test_example_files_exist() -> None:
     """Verify that we found example files to test"""
     assert len(EXAMPLES) > 0, "No example files found"
     print(f"Found {len(EXAMPLES)} examples")
 
 
 @pytest.mark.parametrize("example_file", EXAMPLES)
-def test_run_example(example_file):
+@responses.activate
+def test_run_example(example_file: str) -> None:
     """Run each example file directly using python"""
+    # Skip if optional dependencies are not available
+    if example_file in OPTIONAL_DEPENDENCIES:
+        for module in OPTIONAL_DEPENDENCIES[example_file]:
+            try:
+                __import__(module)
+            except ImportError:
+                pytest.skip(f"Skipping {example_file}: {module} not installed")
+
+    # Setup mock responses for examples that need them
+    if example_file in ["index.py", "file_uploads.py"]:
+        # Mock employee list endpoint
+        responses.add(
+            responses.GET,
+            "https://api.stackone.com/unified/hris/employees",
+            json={
+                "data": [
+                    {
+                        "id": "test-employee-1",
+                        "first_name": "John",
+                        "last_name": "Doe",
+                        "email": "john.doe@example.com"
+                    }
+                ]
+            },
+            status=200
+        )
+        
+        # Mock document upload endpoint  
+        responses.add(
+            responses.POST,
+            "https://api.stackone.com/unified/hris/employees/c28xIQaWQ6MzM5MzczMDA2NzMzMzkwNzIwNA/documents/upload",
+            json={"success": True, "document_id": "test-doc-123"},
+            status=200
+        )
+
     example_path = Path(__file__).parent / example_file
-    result = subprocess.run([sys.executable, str(example_path)], capture_output=True, text=True)
-    if result.returncode != 0:
-        print(f"stdout: {result.stdout}")
-        print(f"stderr: {result.stderr}")
-        pytest.fail(f"Example {example_file} failed with return code {result.returncode}")
+    
+    # Import and run the example module directly
+    spec = importlib.util.spec_from_file_location("example", example_path)
+    if spec and spec.loader:
+        module = importlib.util.module_from_spec(spec)
+        sys.modules["example"] = module
+        spec.loader.exec_module(module)

pyproject.toml

@@ -59,6 +59,7 @@ dev = [
     "pytest-asyncio>=0.25.3",
     "pytest-cov>=6.0.0",
     "pytest-snapshot>=0.9.0",
+    "responses>=0.25.8",
     "ruff>=0.9.6",
     "stackone-ai",
     "types-requests>=2.31.0.20240311",