seitime-frappe/frappe/tests/test_trace.py

163 lines
4.6 KiB
Python

import unittest
from unittest.mock import MagicMock, patch
import frappe
from frappe.model.document import Document
from frappe.model.trace import TracedDocument, trace_fields, traced_field, traced_field_context
def create_mock_meta(doctype):
mock_meta = MagicMock()
mock_meta.get_table_fields.return_value = []
return mock_meta
class TestDocument(Document):
def __init__(self, *args, **kwargs):
kwargs["doctype"] = "TestDocument"
with patch("frappe.get_meta", return_value=create_mock_meta("TestDocument")):
super().__init__(*args, **kwargs)
class TestTracedDocument(TracedDocument):
def __init__(self, *args, **kwargs):
kwargs["doctype"] = "TestTracedDocument"
with patch("frappe.get_meta", return_value=create_mock_meta("TestTracedDocument")):
super().__init__(*args, **kwargs)
test_field = traced_field("test_field", forbidden_values=["forbidden"])
def validate_positive(self, value):
if value <= 0:
raise ValueError("Value must be positive")
positive_field = traced_field("positive_field", custom_validation=validate_positive)
class TestTrace(unittest.TestCase):
def setUp(self):
self.traced_doc = TestTracedDocument()
def test_traced_field_get(self):
self.traced_doc._test_field = "test_value"
self.assertEqual(self.traced_doc.test_field, "test_value")
def test_traced_field_set(self):
self.traced_doc.test_field = "new_value"
self.assertEqual(self.traced_doc._test_field, "new_value")
def test_traced_field_forbidden_value(self):
with self.assertRaises(AssertionError):
self.traced_doc.test_field = "forbidden"
def test_traced_field_custom_validation(self):
self.traced_doc.positive_field = 10
self.assertEqual(self.traced_doc._positive_field, 10)
with self.assertRaises(AssertionError):
self.traced_doc.positive_field = -5
def test_get_valid_dict(self):
self.traced_doc.test_field = "valid_value"
self.traced_doc.positive_field = 15
valid_dict = self.traced_doc.get_valid_dict()
self.assertEqual(valid_dict["test_field"], "valid_value")
self.assertEqual(valid_dict["positive_field"], 15)
class TestTracedFieldContext(unittest.TestCase):
def test_traced_field_context(self):
doc = TestDocument()
# Before context
doc.test_field = "forbidden"
self.assertEqual(doc.test_field, "forbidden")
with traced_field_context(TestDocument, "test_field", forbidden_values=["forbidden"]):
# Inside context
with self.assertRaises(AssertionError):
doc.test_field = "forbidden"
doc.test_field = "allowed"
self.assertEqual(doc.test_field, "allowed")
# After context
doc.test_field = "forbidden"
self.assertEqual(doc.test_field, "forbidden")
def test_traced_field_context_custom_validation(self):
doc = TestDocument()
def validate_even(obj, value):
if value % 2 != 0:
raise ValueError("Value must be even")
with traced_field_context(TestDocument, "number_field", custom_validation=validate_even):
doc.number_field = 2
self.assertEqual(doc.number_field, 2)
with self.assertRaises(AssertionError):
doc.number_field = 3
# After context, validation should not apply
doc.number_field = 3
self.assertEqual(doc.number_field, 3)
def test_traced_field_context_not_in_test_mode(self):
doc = TestDocument()
# Temporarily set frappe.flags.in_test to False
original_in_test = frappe.flags.in_test
frappe.flags.in_test = False
try:
with traced_field_context(TestDocument, "test_field", forbidden_values=["forbidden"]):
with self.assertRaises(frappe.exceptions.ValidationError):
doc.test_field = "forbidden"
doc.test_field = "allowed"
self.assertEqual(doc.test_field, "allowed")
finally:
# Restore the original in_test flag
frappe.flags.in_test = original_in_test
# After context
doc.test_field = "forbidden"
self.assertEqual(doc.test_field, "forbidden")
def validate_positive(obj, value):
if value <= 0:
raise ValueError("Value must be positive")
class TestTraceFieldDecorator(unittest.TestCase):
@trace_fields(decorated_field={"forbidden_values": ["bad"]})
class DecoratedTestDocument(TestDocument):
pass
def test_trace_field_decorator(self):
doc = self.DecoratedTestDocument()
with self.assertRaises(AssertionError):
doc.decorated_field = "bad"
doc.decorated_field = "good"
self.assertEqual(doc.decorated_field, "good")
@trace_fields(positive_field={"custom_validation": validate_positive})
class PositiveFieldDocument(TestDocument):
pass
def test_trace_field_decorator_custom_validation(self):
doc = self.PositiveFieldDocument()
with self.assertRaises(AssertionError):
doc.positive_field = -1
doc.positive_field = 1
self.assertEqual(doc.positive_field, 1)
if __name__ == "__main__":
unittest.main()