mirror of https://github.com/meta-llama/llama-stack.git synced 2025-07-22 04:27:52 +00:00

History

ehhuang 0a6e588f68 Some checks failed Integration Tests / discover-tests (push) Successful in 4s Details Integration Auth Tests / test-matrix (oauth2_token) (push) Failing after 7s Details Test Llama Stack Build / generate-matrix (push) Successful in 7s Details Coverage Badge / unit-tests (push) Failing after 16s Details Test Llama Stack Build / build-single-provider (push) Failing after 11s Details Vector IO Integration Tests / test-matrix (3.13, inline::milvus) (push) Failing after 16s Details Unit Tests / unit-tests (3.12) (push) Failing after 13s Details Test External Providers / test-external-providers (venv) (push) Failing after 12s Details Vector IO Integration Tests / test-matrix (3.12, inline::faiss) (push) Failing after 17s Details Vector IO Integration Tests / test-matrix (3.13, inline::faiss) (push) Failing after 16s Details Python Package Build Test / build (3.12) (push) Failing after 13s Details Test Llama Stack Build / build-custom-container-distribution (push) Failing after 17s Details SqlStore Integration Tests / test-postgres (3.12) (push) Failing after 23s Details Vector IO Integration Tests / test-matrix (3.12, inline::milvus) (push) Failing after 23s Details Vector IO Integration Tests / test-matrix (3.13, remote::pgvector) (push) Failing after 17s Details Update ReadTheDocs / update-readthedocs (push) Failing after 19s Details Vector IO Integration Tests / test-matrix (3.13, inline::sqlite-vec) (push) Failing after 23s Details Test Llama Stack Build / build-ubi9-container-distribution (push) Failing after 21s Details Vector IO Integration Tests / test-matrix (3.12, remote::chromadb) (push) Failing after 18s Details Unit Tests / unit-tests (3.13) (push) Failing after 20s Details Vector IO Integration Tests / test-matrix (3.13, remote::chromadb) (push) Failing after 23s Details Test Llama Stack Build / build (push) Failing after 16s Details Vector IO Integration Tests / test-matrix (3.12, inline::sqlite-vec) (push) Failing after 25s Details Python Package Build Test / build (3.13) (push) Failing after 2m19s Details Vector IO Integration Tests / test-matrix (3.12, remote::pgvector) (push) Failing after 2m25s Details SqlStore Integration Tests / test-postgres (3.13) (push) Failing after 2m32s Details Integration Tests / test-matrix (push) Failing after 2m24s Details Pre-commit / pre-commit (push) Successful in 3m57s Details feat: enable auth for LocalFS Files Provider (#2773 ) # What does this PR do? Supports authentication for LocalFS Files provider. closes https://github.com/meta-llama/llama-stack/issues/2760 ## Test Plan CI. added tests.		2025-07-18 19:11:01 -07:00
..
cli	fix: stop image_name from being cast to an integer (#2759 )	2025-07-15 09:44:21 -07:00
distribution	chore: default to pytest asyncio-mode=auto (#2730 )	2025-07-11 13:00:24 -07:00
files	feat: enable auth for LocalFS Files Provider (#2773 )	2025-07-18 19:11:01 -07:00
models	chore(test): migrate unit tests from unittest to pytest for system prompt (#2789 )	2025-07-18 11:54:02 +02:00
providers	chore(test): migrate unit tests from unittest to pytest nvidia test f… (#2794 )	2025-07-18 12:32:19 +02:00
rag	fix: remove async test markers (fix pre-commit) (#2808 )	2025-07-17 21:35:28 -07:00
registry	chore: default to pytest asyncio-mode=auto (#2730 )	2025-07-11 13:00:24 -07:00
server	chore(test): migrate unit tests from unittest to pytest for server en… (#2795 )	2025-07-17 16:20:12 -07:00
utils	chore: default to pytest asyncio-mode=auto (#2730 )	2025-07-11 13:00:24 -07:00
__init__.py	chore: Add fixtures to conftest.py (#2067 )	2025-05-06 13:57:48 +02:00
conftest.py	chore: block network access from unit tests (#2732 )	2025-07-12 16:53:54 -07:00
fixtures.py	chore: default to pytest asyncio-mode=auto (#2730 )	2025-07-11 13:00:24 -07:00
README.md	test: Measure and track code coverage (#2636 )	2025-07-18 18:08:36 +02:00

README.md

Llama Stack Unit Tests

Unit Tests

Unit tests verify individual components and functions in isolation. They are fast, reliable, and don't require external services.

Prerequisites

Python Environment: Ensure you have Python 3.12+ installed
uv Package Manager: Install uv if not already installed

You can run the unit tests by running:

./scripts/unit-tests.sh [PYTEST_ARGS]

Any additional arguments are passed to pytest. For example, you can specify a test directory, a specific test file, or any pytest flags (e.g., -vvv for verbosity). If no test directory is specified, it defaults to "tests/unit", e.g:

./scripts/unit-tests.sh tests/unit/registry/test_registry.py -vvv

If you'd like to run for a non-default version of Python (currently 3.12), pass PYTHON_VERSION variable as follows:

source .venv/bin/activate
PYTHON_VERSION=3.13 ./scripts/unit-tests.sh

Test Configuration

Test Discovery: Tests are automatically discovered in the tests/unit/ directory
Async Support: Tests use --asyncio-mode=auto for automatic async test handling
Coverage: Tests generate coverage reports in htmlcov/ directory
Python Version: Defaults to Python 3.12, but can be overridden with PYTHON_VERSION environment variable

Coverage Reports

After running tests, you can view coverage reports:

# Open HTML coverage report in browser
open htmlcov/index.html  # macOS
xdg-open htmlcov/index.html  # Linux
start htmlcov/index.html  # Windows