"""本地:python3 -m unittest test_dividend_watch;纯标准库,无网络或数据库。"""
import copy
import datetime as dt
import json
from pathlib import Path
import tempfile
import unittest
from unittest.mock import patch
import dividend_watch as d
import dividend_sources as s
def source():
return {'captured_at': '2026-10-21T08:00:00+08:00', 'expected_date': '2026-10-20',
'data_date': '2026-10-20', 'table': 'gp_stock_factor_pro_202610',
'factors': [{'ts_code': '600001.SH', 'trade_date': '2026-10-20', 'dv_ttm': 5, 'dv_ratio': 9, 'close': 10}],
'names': [{'gp_code_two': '600001.SH', 'gp_name': '示例公司', 'list_status': 'L'}],
'reviews': [], 'fundamentals': {}}
def reviewed(q='好'):
x = source()
x['reviews'] = [{'ts_code': '600001.SH', 'ran_at': '2026-10-20T09:00:00+08:00',
'period_fi': '2026Q1', 'period_rf': '2026Q2', 'grades': {'buffett': '好', 'earnings_quality': '差'},
'summary': {'overall': q, 'thesis': '盈利稳定', 'antithesis': '现金转化下降', 'unknown_n': 3}}]
return x
class ClassificationTest(unittest.TestCase):
def test_risk_variants(self):
for name in ['ST公司', '*ST公司', 'ST公司', 'S*ST公司', 'SST公司', 'XDst公司', 'XR* ST公司', '退市公司', '公司退']:
with self.subTest(name=name): self.assertTrue(d.risk_name(name))
self.assertFalse(d.risk_name('厦门国贸'))
def test_st_before_any_yield(self):
x = source(); x['names'][0]['gp_name'] = '*ST公司'; x['factors'][0]['dv_ttm'] = None
self.assertEqual(d.assemble(x)['rows'][0]['status'], 'excluded')
self.assertEqual(d.candidates(x), [])
def test_missing_name_never_passes(self):
x = source(); x['names'][0]['gp_name'] = ''
self.assertEqual(d.assemble(x)['rows'][0]['status'], 'identity_unknown')
self.assertEqual(d.candidates(x), [])
def test_listing_status_unknown_and_delisted(self):
for v, expected in [(None, 'identity_unknown'), ('D', 'excluded')]:
x = source(); x['names'][0]['list_status'] = v
self.assertEqual(d.assemble(x)['rows'][0]['status'], expected)
def test_boundary_and_missing_not_previous_year(self):
for value, expected in [(5, 'missing_review'), (4.9999, 'below'), (None, 'yield_unknown'), ('NaN', 'yield_unknown')]:
x = source(); x['factors'][0]['dv_ttm'] = value
self.assertEqual(d.assemble(x)['rows'][0]['status'], expected)
def test_good_not_sustainability_approval(self):
r = d.assemble(reviewed())['rows'][0]
self.assertEqual(r['status'], 'priority'); self.assertFalse(r['investment_approved'])
self.assertEqual(r['sustainability'], '待核验')
def test_bad_and_divided(self):
self.assertEqual(d.assemble(reviewed('差'))['rows'][0]['status'], 'risk')
self.assertEqual(d.assemble(reviewed('中'))['rows'][0]['status'], 'mixed')
def test_opposing_view_and_material_age_preserved(self):
r = d.assemble(reviewed())['rows'][0]
self.assertEqual(r['antithesis'], '现金转化下降')
self.assertEqual(r['perspectives']['earnings_quality'], '差')
self.assertTrue(any('2026Q2' in n for n in r['needs']))
def test_quarter_review_due(self):
x = reviewed(); x['reviews'][0]['ran_at'] = '2026-09-30T09:00:00+08:00'
self.assertIn('本季度尚无完整评析更新', d.assemble(x)['rows'][0]['needs'])
def test_future_review_rejected(self):
x = reviewed(); x['reviews'][0]['ran_at'] = '2026-10-21T09:00:00+08:00'
with self.assertRaises(ValueError): d.assemble(x)
def test_duplicate_source_rejected(self):
for key in ('factors', 'names'):
x = source(); x[key].append(copy.deepcopy(x[key][0]))
with self.assertRaises(ValueError): d.assemble(x)
def test_stale_mixed_dates_and_month_table(self):
for change in ({'expected_date': '2026-10-21'}, {'table': 'gp_stock_factor_pro_202609'}, {'data_date': '2026-10-21'}):
x = source(); x.update(change)
with self.assertRaises(ValueError): d.assemble(x)
def test_timezone_required(self):
x = source(); x['captured_at'] = '2026-10-21T08:00:00'
with self.assertRaises(ValueError): d.assemble(x)
def test_november_uses_october_data_table(self):
x = source(); x.update(captured_at='2026-11-02T08:00:00+08:00', expected_date='2026-10-30',data_date='2026-10-30')
x['factors'][0]['trade_date'] = '2026-10-30'
self.assertEqual(d.assemble(x)['source_table'], 'gp_stock_factor_pro_202610')
def test_deterministic_rows(self):
x = source(); second = dict(x['factors'][0], ts_code='600002.SH'); x['factors'].append(second)
a = d.assemble(x); x['factors'].reverse()
self.assertEqual(a, d.assemble(x))
def test_report_escapes_untrusted_prose(self):
x = reviewed(); x['reviews'][0]['summary']['thesis'] = '
'
text = d.report(d.assemble(x))
self.assertNotIn('![]()