~95% on SimpleQA (e.g. Qwen3.6-27B on a 3090). Supports all local and cloud LLMs (llama.cpp, Ollama, Google, ...). 10+ search engines - arXiv, PubMed, your private documents. Everything Local & Encrypted.
Python academiaanthropicarxivbravedeep-researchencryptionhome-automationhomeserverlocallocal-deep-researchlocal-llmmistralollamaopenaipubmedresearchresearch-toolretrieval-augmented-generationsearxngself-hosted
"""
Fixtures for library API tests.
Provides test data and helpers for testing library/collection/RAG endpoints.
"""
import hashlib
import uuid
import pytest
from local_deep_research.database.models.library import (
DocumentStatus,
)
@pytest.fixture
def sample_source_type_data():
"""Sample source type data for test documents."""
return {
"id": str(uuid.uuid4()),
"name": "test_upload",
"display_name": "Test Upload",
"description": "Test documents for API tests",
"icon": "fas fa-file",
}
@pytest.fixture
def sample_collection_data():
"""Sample collection data for tests."""
return {
"name": f"Test Collection {uuid.uuid4().hex[:8]}",
"description": "A test collection for API tests",
"type": "user_uploads",
}
@pytest.fixture
def sample_document_data():
"""Sample document data for tests."""
content = "This is sample text content for testing API endpoints."
return {
"id": str(uuid.uuid4()),
"document_hash": hashlib.sha256(content.encode()).hexdigest(),
"file_size": len(content),
"file_type": "text",
"text_content": content,
"title": "Test Document for API",
"status": DocumentStatus.COMPLETED,
}
def create_test_collection(client, name=None, description=None):
"""
Helper to create a collection via API.
Args:
client: Flask test client (authenticated)
name: Collection name (optional, auto-generated if not provided)
description: Collection description (optional)
Returns:
dict: Created collection data or None if failed
"""
payload = {
"name": name or f"Test Collection {uuid.uuid4().hex[:8]}",
"description": description or "Test collection",
"type": "user_uploads",
}
response = client.post(
"/library/api/collections",
json=payload,
content_type="application/json",
)
if response.status_code == 200:
data = response.get_json()
if data.get("success"):
return data.get("collection")
return None
def delete_test_collection(client, collection_id):
"""
Helper to delete a collection via API.
Args:
client: Flask test client (authenticated)
collection_id: ID of collection to delete
Returns:
bool: True if deleted successfully
"""
response = client.delete(f"/library/api/collections/{collection_id}")
return response.status_code == 200
@pytest.fixture
def create_collection_helper(authenticated_client):
"""Fixture that returns a helper function to create collections."""
created_collections = []
def _create(name=None, description=None):
collection = create_test_collection(
authenticated_client, name, description
)
if collection:
created_collections.append(collection["id"])
return collection
yield _create
# Cleanup: delete all created collections
for coll_id in created_collections:
try:
delete_test_collection(authenticated_client, coll_id)
except Exception:
pass
def get_csrf_token(client):
"""Fetch the session CSRF token for a test client.
Stamps the session by hitting /auth/login first (the CSRF middleware
is always active under FastAPI), then reads the token. Pass the result
as a ``csrf_token`` form field / ``X-CSRFToken`` header on mutating POSTs.
"""
client.get("/auth/login")
return client.get("/auth/csrf-token").json()["csrf_token"]