577 lines
21 KiB
Python
577 lines
21 KiB
Python
"""Tests for cubiomes.search module — basic and advanced conditions."""
|
||
|
||
import json
|
||
import subprocess
|
||
import sys
|
||
|
||
import pytest
|
||
from cubiomes import MCVersion, BiomeID, StructureType, Dimension
|
||
from cubiomes.search import (
|
||
# condition types
|
||
BiomeCondition, StructureCondition,
|
||
SpawnCondition, StrongholdCondition, ProximityCondition,
|
||
QuadStructureCondition, BiomeDensityCondition,
|
||
SlimeDensityCondition, AnyOfBiomes, CustomCondition,
|
||
# main classes
|
||
SearchCriteria, SeedResult, SeedSearch,
|
||
# helpers
|
||
_mc_name, _resolve_mc, _resolve_biome,
|
||
)
|
||
|
||
MC = MCVersion.MC_1_21
|
||
SEED = 123456789
|
||
|
||
|
||
# ─── Helpers ─────────────────────────────────────────────────────────────────
|
||
|
||
class TestHelpers:
|
||
def test_mc_name(self):
|
||
assert _mc_name(MCVersion.MC_1_21) == "1.21.11"
|
||
assert _mc_name(MCVersion.MC_1_18) == "1.18.2"
|
||
assert _mc_name(MCVersion.MC_B1_7) == "B1.7"
|
||
|
||
def test_resolve_mc(self):
|
||
assert _resolve_mc("1.21") == MCVersion.MC_1_21
|
||
|
||
def test_resolve_biome_by_name(self):
|
||
assert _resolve_biome("plains") == BiomeID.plains
|
||
|
||
def test_resolve_biome_by_int(self):
|
||
assert _resolve_biome("1") == 1
|
||
|
||
def test_resolve_biome_unknown(self):
|
||
import argparse
|
||
with pytest.raises(argparse.ArgumentTypeError):
|
||
_resolve_biome("__not_a_biome__")
|
||
|
||
|
||
# ─── SeedResult ───────────────────────────────────────────────────────────────
|
||
|
||
class TestSeedResult:
|
||
def test_as_dict(self):
|
||
r = SeedResult(seed=42, mc=MC,
|
||
biome_positions={"plains": (10, 20)},
|
||
structure_positions={"Village": (100, 200)},
|
||
spawn=(64, -48), spawn_biome=BiomeID.forest,
|
||
extra={"slime_chunk_count": 7})
|
||
d = r.as_dict()
|
||
assert d["seed"] == 42
|
||
assert d["mc_name"] == "1.21.11"
|
||
assert d["extra"]["slime_chunk_count"] == 7
|
||
|
||
def test_str_contains_quad(self):
|
||
r = SeedResult(seed=42, mc=MC,
|
||
quad={"name": "Swamp_Hut", "center": (100, 200),
|
||
"positions": [(90,190),(110,190),(90,210),(110,210)],
|
||
"max_r": 15.0})
|
||
s = str(r)
|
||
assert "quad" in s
|
||
assert "Swamp_Hut" in s
|
||
|
||
def test_str_contains_extra(self):
|
||
r = SeedResult(seed=42, mc=MC, extra={"density_badlands": 0.42})
|
||
assert "0.42" in str(r)
|
||
|
||
|
||
# ─── Basic conditions ─────────────────────────────────────────────────────────
|
||
|
||
class TestBasicConditions:
|
||
def test_biome_match(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
biomes=[BiomeCondition(BiomeID.river, radius=500)],
|
||
)
|
||
result = SeedSearch(criteria).check_seed(SEED)
|
||
assert result is not None
|
||
assert "river" in result.biome_positions
|
||
|
||
def test_structure_match(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
structures=[StructureCondition(StructureType.Village, radius=2000)],
|
||
)
|
||
result = SeedSearch(criteria).check_seed(SEED)
|
||
assert result is not None
|
||
assert "Village" in result.structure_positions
|
||
|
||
def test_slime_chunk_pass(self):
|
||
criteria = SearchCriteria(mc=MC, slime_chunk=(0, 1))
|
||
assert SeedSearch(criteria).check_seed(SEED) is not None
|
||
|
||
def test_slime_chunk_fail(self):
|
||
criteria = SearchCriteria(mc=MC, slime_chunk=(0, 0))
|
||
assert SeedSearch(criteria).check_seed(SEED) is None
|
||
|
||
def test_legacy_spawn_biome(self):
|
||
# Old-style spawn_biome field still works
|
||
sb = SeedSearch(SearchCriteria(mc=MC)).check_seed(SEED, show_spawn=True)
|
||
assert sb is not None
|
||
biome_at_spawn = sb.spawn_biome
|
||
criteria = SearchCriteria(mc=MC, spawn_biome=biome_at_spawn)
|
||
assert SeedSearch(criteria).check_seed(SEED) is not None
|
||
|
||
|
||
# ─── Advanced conditions ──────────────────────────────────────────────────────
|
||
|
||
class TestSpawnCondition:
|
||
def test_spawn_condition_biome(self):
|
||
# First, find the actual spawn biome
|
||
from cubiomes import Generator, Dimension
|
||
g = Generator(MC)
|
||
g.apply_seed(Dimension.DIM_OVERWORLD, SEED)
|
||
sp = g.estimate_spawn()
|
||
sb = g.get_biome_at(sp[0] >> 2, 0, sp[1] >> 2, scale=4)
|
||
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[SpawnCondition(biome_id=sb)],
|
||
)
|
||
result = SeedSearch(criteria).check_seed(SEED)
|
||
assert result is not None
|
||
assert result.spawn_biome == sb
|
||
|
||
def test_spawn_condition_max_distance_pass(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[SpawnCondition(max_distance=10000)],
|
||
)
|
||
assert SeedSearch(criteria).check_seed(SEED) is not None
|
||
|
||
def test_spawn_condition_max_distance_fail(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[SpawnCondition(max_distance=1)],
|
||
)
|
||
# Spawn is at (64, -48) — definitely further than 1 block
|
||
assert SeedSearch(criteria).check_seed(SEED) is None
|
||
|
||
def test_spawn_condition_stores_spawn(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[SpawnCondition(max_distance=10000)],
|
||
)
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
assert r.spawn is not None
|
||
assert isinstance(r.spawn[0], int)
|
||
|
||
|
||
class TestStrongholdCondition:
|
||
def test_stronghold_within_large_radius(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[StrongholdCondition(count=1, max_distance=5000)],
|
||
)
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
assert len(r.strongholds) == 1
|
||
|
||
def test_stronghold_too_far(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[StrongholdCondition(count=1, max_distance=10)],
|
||
)
|
||
# First stronghold is at ~1947 blocks
|
||
assert SeedSearch(criteria).check_seed(SEED) is None
|
||
|
||
def test_stronghold_multiple_count(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[StrongholdCondition(count=3, max_distance=5000)],
|
||
)
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
assert len(r.strongholds) == 3
|
||
|
||
def test_strongholds_in_result(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[StrongholdCondition(count=2, max_distance=5000)],
|
||
)
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
for sh in r.strongholds:
|
||
assert isinstance(sh[0], int) and isinstance(sh[1], int)
|
||
|
||
|
||
class TestProximityCondition:
|
||
def test_proximity_loose(self):
|
||
# Village and Monument within 5000 blocks of each other should be easy
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[ProximityCondition(
|
||
struct_a=StructureType.Village,
|
||
struct_b=StructureType.Monument,
|
||
max_dist=5000, search_radius=4000,
|
||
)],
|
||
)
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
assert "Village" in r.structure_positions
|
||
assert "Monument" in r.structure_positions
|
||
|
||
def test_proximity_impossible(self):
|
||
# Village within 1 block of Monument — impossible
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[ProximityCondition(
|
||
struct_a=StructureType.Village,
|
||
struct_b=StructureType.Monument,
|
||
max_dist=1, search_radius=4000,
|
||
)],
|
||
)
|
||
assert SeedSearch(criteria).check_seed(SEED) is None
|
||
|
||
def test_proximity_distance_recorded(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[ProximityCondition(
|
||
StructureType.Village, StructureType.Monument,
|
||
max_dist=5000, search_radius=4000,
|
||
)],
|
||
)
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
if r is not None:
|
||
import math
|
||
va = r.structure_positions.get("Village")
|
||
mo = r.structure_positions.get("Monument")
|
||
if va and mo:
|
||
d = math.sqrt((va[0]-mo[0])**2 + (va[1]-mo[1])**2)
|
||
assert d <= 5000
|
||
|
||
|
||
class TestQuadStructureCondition:
|
||
def test_quad_no_result_for_tight_limit(self):
|
||
# Strict quad (max_dist=1) should fail for this seed
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[QuadStructureCondition(
|
||
StructureType.Swamp_Hut, max_dist=1, max_regions=2,
|
||
)],
|
||
)
|
||
assert SeedSearch(criteria).check_seed(SEED) is None
|
||
|
||
def test_quad_result_structure(self):
|
||
# Loose quad (max_dist=9999) should find something in a range search
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[QuadStructureCondition(
|
||
StructureType.Village, max_dist=9999, max_regions=2,
|
||
)],
|
||
)
|
||
results = list(SeedSearch(criteria).run(seed_range=(0, 200), count=2))
|
||
for r in results:
|
||
assert r.quad is not None
|
||
assert r.quad["name"] == "Village"
|
||
assert len(r.quad["positions"]) == 4
|
||
assert "center" in r.quad
|
||
assert "max_r" in r.quad
|
||
|
||
def test_quad_positions_in_structure_positions(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[QuadStructureCondition(
|
||
StructureType.Village, max_dist=9999, max_regions=2,
|
||
)],
|
||
)
|
||
results = list(SeedSearch(criteria).run(seed_range=(0, 50), count=1))
|
||
if results:
|
||
r = results[0]
|
||
assert any("Village_quad_" in k for k in r.structure_positions)
|
||
|
||
|
||
class TestBiomeDensityCondition:
|
||
def test_density_always_passes_with_zero(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[BiomeDensityCondition(
|
||
biome_id=BiomeID.ocean, min_fraction=0.0,
|
||
x=-128, z=-128, sx=256, sz=256,
|
||
)],
|
||
)
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
|
||
def test_density_fails_impossible(self):
|
||
# 100% cherry grove in 512×512 — impossible
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[BiomeDensityCondition(
|
||
biome_id=BiomeID.cherry_grove, min_fraction=1.0,
|
||
x=-128, z=-128, sx=64, sz=64,
|
||
)],
|
||
)
|
||
assert SeedSearch(criteria).check_seed(SEED) is None
|
||
|
||
def test_density_stored_in_extra(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[BiomeDensityCondition(
|
||
biome_id=BiomeID.plains, min_fraction=0.0,
|
||
x=-64, z=-64, sx=128, sz=128,
|
||
)],
|
||
)
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
assert any("density_plains" in k for k in r.extra)
|
||
|
||
|
||
class TestSlimeDensityCondition:
|
||
def test_slime_density_zero_always_passes(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[SlimeDensityCondition(min_count=0, cx=-4, cz=-4, cw=9, ch=9)],
|
||
)
|
||
assert SeedSearch(criteria).check_seed(SEED) is not None
|
||
|
||
def test_slime_density_too_high_fails(self):
|
||
# Require all 81 slime chunks — impossible
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[SlimeDensityCondition(min_count=81, cx=-4, cz=-4, cw=9, ch=9)],
|
||
)
|
||
assert SeedSearch(criteria).check_seed(SEED) is None
|
||
|
||
def test_slime_density_count_in_extra(self):
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[SlimeDensityCondition(min_count=0, cx=-4, cz=-4, cw=9, ch=9)],
|
||
)
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
assert "slime_chunk_count" in r.extra
|
||
assert isinstance(r.extra["slime_chunk_count"], int)
|
||
|
||
|
||
class TestAnyOfBiomes:
|
||
def test_any_biomes_one_match(self):
|
||
# river is at (0,0) for this seed
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[AnyOfBiomes(
|
||
[BiomeID.river, BiomeID.mushroom_fields], radius=500,
|
||
)],
|
||
)
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
assert any("any_of(" in k for k in r.biome_positions)
|
||
|
||
def test_any_biomes_none_match(self):
|
||
# Impossible list, tiny radius
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[AnyOfBiomes([BiomeID.mushroom_fields], radius=1)],
|
||
)
|
||
assert SeedSearch(criteria).check_seed(SEED) is None
|
||
|
||
def test_any_biomes_or_semantics(self):
|
||
# Both options are valid — should return on first found
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
conditions=[AnyOfBiomes([BiomeID.river, BiomeID.ocean], radius=2000)],
|
||
)
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
|
||
|
||
class TestCustomCondition:
|
||
def test_custom_pass(self):
|
||
def always_true(seed, mc):
|
||
return True
|
||
|
||
criteria = SearchCriteria(mc=MC, conditions=[CustomCondition(always_true)])
|
||
assert SeedSearch(criteria).check_seed(SEED) is not None
|
||
|
||
def test_custom_fail(self):
|
||
def always_false(seed, mc):
|
||
return False
|
||
|
||
criteria = SearchCriteria(mc=MC, conditions=[CustomCondition(always_false)])
|
||
assert SeedSearch(criteria).check_seed(SEED) is None
|
||
|
||
def test_custom_returns_dict(self):
|
||
def returns_data(seed, mc):
|
||
return {"custom_key": 42, "seed_doubled": seed * 2}
|
||
|
||
criteria = SearchCriteria(mc=MC, conditions=[CustomCondition(returns_data)])
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
assert r.extra["custom_key"] == 42
|
||
assert r.extra["seed_doubled"] == SEED * 2
|
||
|
||
def test_custom_with_generator(self):
|
||
from cubiomes import Generator, Dimension
|
||
|
||
def check_village_close(seed, mc):
|
||
from cubiomes import get_structure_pos, is_viable_structure_pos, StructureType
|
||
g = Generator(mc)
|
||
g.apply_seed(Dimension.DIM_OVERWORLD, seed)
|
||
for rx in range(-2, 3):
|
||
for rz in range(-2, 3):
|
||
pos = get_structure_pos(StructureType.Village, mc, seed, rx, rz)
|
||
if pos and is_viable_structure_pos(StructureType.Village, g, *pos):
|
||
if pos[0]**2 + pos[1]**2 <= 500**2:
|
||
return {"closest_village": pos}
|
||
return False
|
||
|
||
criteria = SearchCriteria(mc=MC, conditions=[CustomCondition(check_village_close)])
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
assert "closest_village" in r.extra
|
||
|
||
def test_custom_combined_with_native(self):
|
||
def extra_check(seed, mc):
|
||
return seed % 2 == 1
|
||
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
structures=[StructureCondition(StructureType.Village, radius=2000)],
|
||
conditions=[CustomCondition(extra_check)],
|
||
)
|
||
# SEED=123456789 is odd, so custom passes; Village exists so native passes
|
||
r = SeedSearch(criteria).check_seed(SEED)
|
||
assert r is not None
|
||
|
||
|
||
# ─── SearchCriteria combined ──────────────────────────────────────────────────
|
||
|
||
class TestCombinedCriteria:
|
||
def test_all_conditions_must_pass(self):
|
||
# Village nearby AND impossible density — should fail
|
||
criteria = SearchCriteria(
|
||
mc=MC,
|
||
structures=[StructureCondition(StructureType.Village, radius=2000)],
|
||
conditions=[BiomeDensityCondition(
|
||
BiomeID.mushroom_fields, min_fraction=1.0,
|
||
x=-64, z=-64, sx=128, sz=128,
|
||
)],
|
||
)
|
||
assert SeedSearch(criteria).check_seed(SEED) is None
|
||
|
||
def test_empty_criteria_always_passes(self):
|
||
criteria = SearchCriteria(mc=MC)
|
||
assert SeedSearch(criteria).check_seed(SEED) is not None
|
||
|
||
def test_run_respects_count(self):
|
||
criteria = SearchCriteria(mc=MC)
|
||
results = list(SeedSearch(criteria).run(seed_range=(0, 1000), count=3))
|
||
assert len(results) == 3
|
||
|
||
|
||
# ─── CLI ─────────────────────────────────────────────────────────────────────
|
||
|
||
class TestCLI:
|
||
def _run(self, *args):
|
||
return subprocess.run(
|
||
[sys.executable, "-m", "cubiomes.search"] + list(args),
|
||
capture_output=True, text=True,
|
||
)
|
||
|
||
def test_help(self):
|
||
r = self._run("--help")
|
||
assert r.returncode == 0
|
||
assert "quad" in r.stdout.lower()
|
||
assert "proximity" in r.stdout.lower()
|
||
|
||
def test_info_mode(self):
|
||
r = self._run("--seed", str(SEED), "--info")
|
||
assert r.returncode == 0
|
||
assert str(SEED) in r.stdout
|
||
assert "strongholds" in r.stdout.lower()
|
||
|
||
def test_single_seed_match(self):
|
||
r = self._run("--seed", str(SEED),
|
||
"--structure", "Village", "--struct-radius", "500")
|
||
assert r.returncode == 0
|
||
assert "Village" in r.stdout
|
||
|
||
def test_single_seed_no_match(self):
|
||
r = self._run("--seed", str(SEED),
|
||
"--structure", "Village", "--struct-radius", "1")
|
||
assert r.returncode == 1
|
||
|
||
def test_range_json(self):
|
||
r = self._run("--seeds", "0:200",
|
||
"--structure", "Village", "--struct-radius", "300",
|
||
"--count", "2", "--format", "json", "--no-progress")
|
||
assert r.returncode == 0
|
||
data = json.loads(r.stdout)
|
||
assert isinstance(data, list)
|
||
|
||
def test_range_csv(self):
|
||
r = self._run("--seeds", "0:200",
|
||
"--structure", "Village", "--struct-radius", "300",
|
||
"--count", "2", "--format", "csv", "--no-progress")
|
||
assert r.returncode == 0
|
||
lines = r.stdout.strip().split("\n")
|
||
assert lines[0].startswith("seed,mc,")
|
||
|
||
def test_any_biome_flag(self):
|
||
r = self._run("--seed", str(SEED),
|
||
"--any-biome", "river", "ocean", "--biome-radius", "500")
|
||
assert r.returncode == 0
|
||
|
||
def test_spawn_biome_flag(self):
|
||
# Get spawn biome first
|
||
from cubiomes import Generator, Dimension
|
||
g = Generator(MC)
|
||
g.apply_seed(Dimension.DIM_OVERWORLD, SEED)
|
||
sp = g.estimate_spawn()
|
||
sb = g.get_biome_at(sp[0] >> 2, 0, sp[1] >> 2, scale=4)
|
||
bname = BiomeID(sb).name
|
||
|
||
r = self._run("--seed", str(SEED), "--spawn-biome", bname)
|
||
assert r.returncode == 0
|
||
|
||
def test_spawn_max_dist_pass(self):
|
||
r = self._run("--seed", str(SEED), "--spawn-max-dist", "10000")
|
||
assert r.returncode == 0
|
||
|
||
def test_spawn_max_dist_fail(self):
|
||
r = self._run("--seed", str(SEED), "--spawn-max-dist", "1")
|
||
assert r.returncode == 1
|
||
|
||
def test_stronghold_radius_flag(self):
|
||
r = self._run("--seed", str(SEED),
|
||
"--stronghold-radius", "5000", "--stronghold-count", "1")
|
||
assert r.returncode == 0
|
||
|
||
def test_proximity_flag(self):
|
||
r = self._run("--seed", str(SEED),
|
||
"--proximity", "Village", "Monument", "5000",
|
||
"--no-progress")
|
||
assert r.returncode == 0
|
||
assert "Village" in r.stdout
|
||
assert "Monument" in r.stdout
|
||
|
||
def test_proximity_fail(self):
|
||
r = self._run("--seed", str(SEED),
|
||
"--proximity", "Village", "Monument", "1",
|
||
"--no-progress")
|
||
assert r.returncode == 1
|
||
|
||
def test_biome_density_flag(self):
|
||
r = self._run("--seed", str(SEED),
|
||
"--biome-density", "river", "0.0",
|
||
"--no-progress")
|
||
assert r.returncode == 0
|
||
|
||
def test_min_slime_chunks_flag(self):
|
||
r = self._run("--seed", str(SEED), "--min-slime-chunks", "1")
|
||
assert r.returncode == 0
|
||
|
||
def test_min_slime_chunks_impossible(self):
|
||
r = self._run("--seed", str(SEED), "--min-slime-chunks", "81")
|
||
assert r.returncode == 1
|
||
|
||
def test_quad_flag_range(self):
|
||
# Loose quad should find results quickly
|
||
r = self._run("--seeds", "0:50",
|
||
"--quad", "Village", "--quad-dist", "9999",
|
||
"--quad-max-regions", "2",
|
||
"--count", "1", "--no-progress")
|
||
assert r.returncode == 0
|
||
|
||
def test_unknown_biome(self):
|
||
r = self._run("--biome", "__no_such_biome__", "--seeds", "0:10")
|
||
assert r.returncode != 0
|