import hashlib import json import subprocess import tempfile from pathlib import Path from datetime import timedelta from unittest.mock import patch from asgiref.sync import async_to_sync from django.contrib.auth import get_user_model from django.core.exceptions import ValidationError from django.test import Client, TestCase, override_settings from django.urls import reverse from django.utils import timezone from mcp.server.auth.provider import AccessToken from mcp.server.mcpserver.exceptions import ToolError from mcp_server.server import create_server from .documentation import (_fetch_snapshot, _git_env, _repository_url, audit_status, document_diff, document_history, historical_document, normal_path, sync_project) from .models import DocumentationSync, Membership, ProjectDocument from .services import create_project from .templatetags.project_markdown import render_document_markdown class DocumentationTests(TestCase): def setUp(self): users = get_user_model() self.owner = users.objects.create_user('docs-owner', password='password') self.viewer = users.objects.create_user('docs-viewer', password='password') self.outsider = users.objects.create_user('docs-outsider', password='password') self.project = create_project(self.owner, name='Documentation test', git_repository_url='https://git.jorendegraaf.eu/owner/project.git') Membership.objects.create(project=self.project, user=self.viewer, role='viewer') def snapshot(self, path='docs/guide.md', markdown='# Guide\n\n[Next](next.md)\n', commit='a' * 40): item = ProjectDocument(project=self.project, path=path, title='Guide', headings=['Guide'], markdown=markdown, content_hash=hashlib.sha256(markdown.encode()).hexdigest(), source_commit=commit) return (self.project.git_repository_url, 'refs/heads/main', commit, timezone.now(), [item], {}) def import_snapshot(self): with patch('projects.documentation._fetch_snapshot', return_value=self.snapshot()): return sync_project(self.owner, self.project) def test_sync_replaces_deleted_documents_and_retains_last_good_on_error(self): state = self.import_snapshot() self.assertEqual(ProjectDocument.objects.filter(project=self.project).count(), 1) self.assertEqual(state.indexed_commit, 'a' * 40) DocumentationSync.objects.filter(project=self.project).update(last_attempt_at=timezone.now() - timedelta(minutes=2)) with patch('projects.documentation._fetch_snapshot', return_value=self.snapshot('README.md', '# New\n', 'b' * 40)): sync_project(self.owner, self.project, force=True) self.assertFalse(ProjectDocument.objects.filter(project=self.project, path='docs/guide.md').exists()) self.assertTrue(ProjectDocument.objects.filter(project=self.project, path='README.md').exists()) DocumentationSync.objects.filter(project=self.project).update(last_attempt_at=timezone.now() - timedelta(minutes=2)) from .documentation import DocumentationError with patch('projects.documentation._fetch_snapshot', side_effect=DocumentationError('fetch unavailable')): state = sync_project(self.owner, self.project, force=True) self.assertEqual(state.indexed_commit, 'b' * 40) self.assertIn('fetch unavailable', state.last_error) self.assertTrue(ProjectDocument.objects.filter(project=self.project, path='README.md').exists()) def test_permissions_views_and_refresh(self): self.import_snapshot() home = reverse('projects:docs_home', args=[self.project.pk]) detail = reverse('projects:docs_document', args=[self.project.pk, 'docs/guide.md']) refresh = reverse('projects:docs_refresh', args=[self.project.pk]) self.assertEqual(self.client.get(home).status_code, 302) self.client.force_login(self.outsider) self.assertEqual(self.client.get(home).status_code, 404) self.assertEqual(self.client.get(detail).status_code, 404) self.client.force_login(self.viewer) self.assertContains(self.client.get(home), 'docs/guide.md') self.assertContains(self.client.get(detail), 'Guide') self.assertEqual(self.client.post(refresh).status_code, 403) self.client.force_login(self.owner) self.assertEqual(self.client.get(reverse('projects:docs_document', args=[self.project.pk, 'docs/../secret.md'])).status_code, 404) csrf_client = Client(enforce_csrf_checks=True, HTTP_HOST='localhost') csrf_client.force_login(self.owner) self.assertEqual(csrf_client.post(refresh).status_code, 403) csrf_client.get(home) self.assertEqual(csrf_client.post(refresh, HTTP_X_CSRFTOKEN=csrf_client.cookies['csrftoken'].value).status_code, 302) def test_markdown_links_and_untrusted_html(self): html = str(render_document_markdown('# Guide\n\n[Next](next.md) [Missing](absent.md)\n\n', self.project.pk, 'docs/guide.md', {'docs/guide.md', 'docs/next.md'})) self.assertIn(f'/projects/{self.project.pk}/docs/docs/next.md/', html) self.assertIn('