trustgraph/TEST_SETUP.md

Quick Test Setup Guide

TL;DR - Just Run This

# From the trustgraph project root directory
./run_tests.sh

This script will:

1. Check current imports
2. Install all required TrustGraph packages
3. Install test dependencies
4. Run the VertexAI tests

If You Get Import Errors

The most common issue is that TrustGraph packages aren't installed. Here's how to fix it:

Step 1: Check What's Missing

./check_imports.py

Step 2: Install TrustGraph Packages

./install_packages.sh

Step 3: Verify Installation

./check_imports.py

Step 4: Run Tests

pytest tests/unit/test_text_completion/test_vertexai_processor.py -v

What the Scripts Do

check_imports.py

• Tests all the imports needed for the tests
• Shows exactly what's missing
• Helps diagnose import issues

install_packages.sh

• Installs trustgraph-base (required by others)
• Installs trustgraph-cli
• Installs trustgraph-vertexai
• Installs trustgraph-flow
• Uses pip install -e . for editable installs

run_tests.sh

• Runs all the above steps in order
• Installs test dependencies
• Runs the VertexAI tests
• Shows clear output at each step

Manual Installation (If Scripts Don't Work)

# Install packages in order (base first!)
cd trustgraph-base && pip install -e . && cd ..
cd trustgraph-cli && pip install -e . && cd ..
cd trustgraph-vertexai && pip install -e . && cd ..
cd trustgraph-flow && pip install -e . && cd ..

# Install test dependencies
cd tests && pip install -r requirements.txt && cd ..

# Run tests
pytest tests/unit/test_text_completion/test_vertexai_processor.py -v

Common Issues

1. "No module named 'trustgraph'" → Run ./install_packages.sh
2. "No module named 'trustgraph.base'" → Install trustgraph-base first
3. "No module named 'trustgraph.model.text_completion.vertexai'" → Install trustgraph-vertexai
4. Scripts not executable → Run chmod +x *.sh
5. Wrong directory → Make sure you're in the project root (where README.md is)

Test Results

When working correctly, you should see:

• ✅ All imports successful
• 139 test cases running
• Tests passing (or failing for logical reasons, not import errors)

Getting Help

If you're still having issues:

1. Share the output of ./check_imports.py
2. Share the exact error message
3. Confirm you're in the right directory: /home/mark/work/trustgraph.ai/trustgraph