import json
import subprocess
import tempfile
import unittest
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
class BuildTests(unittest.TestCase):
@classmethod
def setUpClass(cls):
subprocess.run(["python", "tools/build.py"], cwd=ROOT, check=True)
def test_expected_artifacts(self):
expected = {"ravenous.html", "ravenous.css", "translation.json", "sheet.json", "build-info.json"}
actual = {path.name for path in (ROOT / "build").iterdir()}
self.assertTrue(expected.issubset(actual))
self.assertLessEqual(actual - expected, {
"example-character.json", "example-craft-forge.json", "example-craft-alchemy.json",
"example-monster-2.json", "example-monster-5.json"
})
def test_jenkins_publishes_only_below_project_asset_root(self):
pipeline = (ROOT / "Jenkinsfile").read_text(encoding="utf-8")
deploy_root = "/mnt/assets/ravenous_roll20"
self.assertIn(f"DEPLOY_ROOT = '{deploy_root}'", pipeline)
self.assertNotIn("/mnt/books", pipeline)
for product in ("ravenous_sheet", "ravenous_craft", "ravenous_effects"):
for suffix in ("", "_candlelight", "_lighthouse"):
self.assertIn(f"'{deploy_root}/{product}{suffix}'", pipeline)
self.assertEqual(3, pipeline.count('mkdir -p "${targetDir}"'))
def test_jenkins_badge_lifecycle_and_readme_urls(self):
pipeline = (ROOT / "Jenkinsfile").read_text(encoding="utf-8")
readme = (ROOT / "README.md").read_text(encoding="utf-8")
badge_root = "https://assets.dandaedre.com/coverage/Ravenous/ravenous_roll20/main"
self.assertIn("post {", pipeline)
self.assertIn("cleanup {", pipeline)
self.assertIn('coverage/.tests-passed-$BUILD_NUMBER', pipeline)
self.assertIn('coverage/.coverage-ready-$BUILD_NUMBER', pipeline)
self.assertIn("BADGE_PUBLICATION_ROOT = '/mnt/assets/coverage'", pipeline)
self.assertIn("artifacts: 'coverage/version.svg,coverage/test.svg,coverage/coverage.svg'", pipeline)
for badge in ("version", "test", "coverage"):
self.assertEqual(1, readme.count(f"{badge_root}/{badge}.svg"))
def test_source_data_was_imported(self):
info = json.loads((ROOT / "build/build-info.json").read_text())
self.assertGreaterEqual(info["schools"], 10)
self.assertGreater(info["techniques"], 100)
self.assertGreater(info["skills"], 10)
def test_typst_references_and_difficulties_are_rendered(self):
from tools.build import difficulty_stars, read_glossary_labels, translate_typst
glossary = read_glossary_labels()
self.assertEqual("Concussif", translate_typst("@al_concussif", glossary))
self.assertEqual("★ ★★ ★★★ 4★ -★ -4★ 0★", " ".join(
difficulty_stars(value) for value in ("1", "2", "3", "4", "-1", "-4", "0")
))
self.assertEqual("Concussif (★★)",
translate_typst("@al_concussif (#ddlvl(2))", glossary))
def test_roll20_constraints(self):
sheet = (ROOT / "build/ravenous.html").read_text()
self.assertNotIn("{{SKILL_ROWS}}", sheet)
self.assertNotIn("
', sheet)
for section in ("customskills", "attacks", "protections", "locations", "consumables", "modifiers", "techniques", "powers"):
self.assertIn(f'class="repeating_{section}"', sheet)
self.assertIn('value="!ravenous-export --id @{character_id}"', sheet)
self.assertIn('value="!ravenous-import --replace --id @{character_id} --handout ?{ID du handout personnage}"', sheet)
self.assertIn('value="!ravenous-export-craft --id @{character_id}"', sheet)
self.assertIn('value="!ravenous-export-effects --id @{character_id}"', sheet)
self.assertIn('value="!ravenous-import-effects --id @{character_id} --handout ?{ID du handout effets}"', sheet)
self.assertIn('Échanges JSON', sheet)
self.assertIn('value="!ravenous-import-craft --id @{character_id} --handout ?{ID du handout artisanat}"', sheet)
def test_origins_and_powers_are_imported(self):
from tools.build import read_glossary_labels, read_origins
origins = read_origins(read_glossary_labels())
self.assertEqual(26, len(origins))
self.assertEqual("Renouveau", origins["dragon_1"]["powers"][0]["name"])
self.assertEqual("1", origins["dragon_1"]["powers"][0]["stage"])
self.assertIn("Cette mort ne vous inflige aucun malus de mort.", origins["dragon_1"]["powers"][0]["description"])
sheet = (ROOT / "build/ravenous.html").read_text()
self.assertIn('name="attr_origin_key"', sheet)
self.assertIn('name="act_tab_powers"', sheet)
self.assertIn('name="act_add_power_stage"', sheet)
self.assertIn('name="attr_power_stage_to_add"', sheet)
self.assertIn('name="attr_source_key"', sheet)
def test_technique_tier_limit_comes_from_typst_config(self):
info = json.loads((ROOT / "build/build-info.json").read_text())
sheet = (ROOT / "build/ravenous.html").read_text()
self.assertEqual(5, info["max_tier_exclusive"])
self.assertNotIn('"tier":"5"', sheet)
def test_general_skills_are_built_in_and_techniques_are_individual(self):
sheet = (ROOT / "build/ravenous.html").read_text()
self.assertIn('name="attr_parade"', sheet)
self.assertNotIn('class="repeating_skills"', sheet)
self.assertIn('name="act_add_technique"', sheet)
self.assertNotIn('name="act_import_school"', sheet)
def test_consumables_and_effects_are_freeform_chat_cards(self):
sheet = (ROOT / "build/ravenous.html").read_text()
self.assertIn('name="act_tab_effects"', sheet)
self.assertLess(sheet.index('name="act_tab_powers"'), sheet.index('name="act_tab_effects"'))
self.assertIn('class="page page-effects"', sheet)
self.assertIn('rows="2" placeholder="Effet et conditions', sheet)
self.assertGreaterEqual(sheet.count('class="use-effect"'), 2)
self.assertIn("{{duration=@{duration}}}", sheet)
self.assertIn("{{details=@{description}}}", sheet)
self.assertNotIn('name="attr_skill_target"', sheet)
self.assertNotIn('class="multi-modifiers"', sheet)
def test_derived_statistics_have_formulas_and_modifiers(self):
sheet = (ROOT / "build/ravenous.html").read_text()
for modifier in ("torque_modifier", "speed_modifier", "hp_modifier", "jauge_max_modifier", "fatigue_max_modifier", "toxicite_max_modifier", "satiete_max_modifier", "actions_max_modifier"):
self.assertIn(f'name="attr_{modifier}"', sheet)
for formula in ("force * 5", "force + will + 2", "hpBase + 2", "agility * 3", "8 + stage", "6 + Math.floor(stage / 2)"):
self.assertIn(formula, sheet)
self.assertNotIn('name="attr_force_mod"', sheet)
self.assertNotIn('name="attr_psy_mod"', sheet)
def test_health_locations_resistances_and_movement_modifiers(self):
sheet = (ROOT / "build/ravenous.html").read_text()
for location in ("head", "torso", "left_arm", "right_arm", "left_leg", "right_leg"):
for field in ("hp", "hp_max", "protection", "armor", "armor_max"):
self.assertIn(f'name="attr_{location}_{field}"', sheet)
for resistance in ("slash", "pierce", "blunt", "fire", "earth", "wood", "magma", "water", "wind", "ice", "lightning", "abyssal", "celestial"):
self.assertIn(f'name="attr_resist_{resistance}"', sheet)
for movement in ("half_speed", "run_speed", "swim_speed", "fly_speed"):
self.assertIn(f'name="attr_{movement}_modifier"', sheet)
self.assertIn('name="act_tab_health"', sheet)
def test_attack_defense_and_damage_workflow(self):
sheet = (ROOT / "build/ravenous.html").read_text()
for field in ("base_damage", "damage_per_success", "break_damage", "dodge_threshold", "parry_threshold", "reposition_threshold"):
self.assertIn(f'name="attr_{field}"', sheet)
self.assertIn('name="act_defend"', sheet)
self.assertIn('name="act_damage"', sheet)
self.assertIn("clicked:repeating_attacks:defend", sheet)
self.assertIn("clicked:repeating_attacks:damage", sheet)
self.assertIn("Repositionnement (${repositionTarget})", sheet)
self.assertIn("Math.min(remaining", sheet)
self.assertIn("(finalSuccesses - 1)", sheet)
self.assertIn("{{defense_successes=[[0]]}}", sheet)
self.assertIn("attackRolls[event.originalRollId]", sheet)
self.assertIn("?{Succès restants|1}", sheet)
self.assertIn("@{target|Défenseur|esquive}+@{target|Défenseur|esquive_temp}", sheet)
self.assertIn("@{target|Défenseur|parade}+@{target|Défenseur|parade_temp}", sheet)
self.assertNotIn("@{target|Défenseur|esquive_total}", sheet)
self.assertNotIn("@{target|Défenseur|parade_total}", sheet)
self.assertIn("{{subtitle=@{target|Défenseur|character_name}}}", sheet)
self.assertIn("Esquive (${dodgeThreshold} + @{target|Défenseur|esquive} + @{target|Défenseur|esquive_temp})", sheet)
self.assertIn('d10<${number(get("threshold")) + number(get("temp"))}', sheet)
self.assertIn("d10<${defenseQuery}+?{Bonus|0}", sheet)
self.assertIn('name="act_take_damage"', sheet)
self.assertIn('Options avancées
', sheet)
self.assertIn('class="attack-notes" name="attr_notes" rows="2"', sheet)
self.assertIn("clicked:repeating_attacks:take_damage", sheet)
self.assertIn("damage_resistance_total", sheet)
self.assertIn("active_protection_total", sheet)
self.assertIn("resistanceReduction", sheet)
self.assertIn("{{computed::resistance_reduction}} (resist) − {{computed::protection_reduction}} (armor)", sheet)
self.assertIn('name="attr_secret_rolls"', sheet)
self.assertIn('values.secret_rolls === "1" ? "/w gm " : ""', sheet)
self.assertIn("@{target|Défenseur|roll_whisper}", sheet)
self.assertIn("active_first_protection", sheet)
self.assertIn("damage_location_query", sheet)
self.assertIn("repeating_locations_${id}_name", sheet)
self.assertIn("incomingBreak - breakResistance - firstProtection", sheet)
self.assertNotIn("{{break_damage=[[0]]}}}", sheet)
def test_techniques_are_chat_activatable_and_typst_free(self):
sheet = (ROOT / "build/ravenous.html").read_text()
technique_data = sheet.split("const TECHNIQUES = ", 1)[1].split(";\n", 1)[0]
self.assertIn('class="activate-technique" type="action" name="act_activate"', sheet)
self.assertIn('name="attr_effect_ids"', sheet)
self.assertIn('clicked:repeating_techniques:activate', sheet)
self.assertNotRegex(technique_data, r"[@#][A-Za-z_]")
def test_effect_reminder_metadata_is_inferred_from_rule_text(self):
from tools.build import effect_reminder_metadata
start = effect_reminder_metadata("Au début de votre tour, subissez 3 dégâts. Jusqu'au début de votre prochain tour, résistez.")
self.assertEqual("until_start", start["duration_type"])
self.assertIn("subissez 3 dégâts", start["start_reminder"])
end = effect_reminder_metadata("À la fin de chaque tour, récupérez 1 Jauge. Cet effet dure trois tours.")
self.assertEqual(3, end["remaining"])
self.assertEqual("end", end["countdown_phase"])
self.assertIn("récupérez 1 Jauge", end["end_reminder"])
self.assertEqual("combat", effect_reminder_metadata("Bonus jusqu'à la fin du combat.")["duration_type"])
def test_generated_worker_data_has_bounded_line_lengths(self):
sheet = (ROOT / "build/ravenous.html").read_text()
worker = sheet.split('', 1)[0]
self.assertLess(max(map(len, worker.splitlines())), 12000)
def test_school_trigrams_come_from_book_config(self):
from tools.build import read_build_config, read_glossary_labels, read_schools, technique_options
config = read_build_config()
schools = read_schools(int(config["build"]["max_tier_exclusive"]), read_glossary_labels())
options, indexed = technique_options(schools, config["schools"]["trigrams"])
self.assertIn('