Test berbasis properti membantu memeriksa banyak kemungkinan susunan menara, bukan hanya beberapa contoh tetap. Caranya: tentukan model balok dan aturan stabilitas yang eksplisit, buat operasi tambah atau pindah, lalu verifikasi invarians pada hasilnya.

Panduan ini memakai Python dan Hypothesis. Modelnya sengaja sederhana untuk menguji logika perangkat lunak; model ini tidak membuktikan keamanan struktur nyata dan bukan pengganti analisis teknik sipil.

Tentukan model dan batas aturan

Representasikan setiap balok sebagai persegi panjang pada bidang horizontal, dengan tinggi berupa lapisan bilangan bulat. Balok berada di atas balok lain jika lapisannya tepat satu tingkat lebih tinggi dan area alasnya tertutup oleh balok pendukung. Aturan ini menyederhanakan simulasi dengan mengabaikan massa, gesekan, deformasi, toleransi ukuran, dan gaya.

Contoh berikut menganggap semua koordinat dan ukuran berupa bilangan bulat. Dua balok pada lapisan yang sama tidak boleh bertumpang tindih. Balok di lapisan dasar tidak membutuhkan penyangga, sedangkan setiap balok di atasnya harus memiliki setidaknya satu penyangga yang menutupi seluruh alasnya.

Implementasikan validasi sederhana

Model dibuat sebagai dataclass beku agar operasi menghasilkan susunan baru, bukan mengubah keadaan lama. Dengan demikian, operasi yang ditolak tidak meninggalkan perubahan parsial.

from dataclasses import dataclass

@dataclass(frozen=True)
class Block:
    id: int
    x: int
    y: int
    z: int
    width: int
    depth: int

def overlaps(a, b):
    return (
        a.x < b.x + b.width and b.x < a.x + a.width
        and a.y < b.y + b.depth and b.y < a.y + a.depth
    )

def supports(lower, upper):
    return (
        lower.z + 1 == upper.z
        and lower.x <= upper.x
        and lower.y <= upper.y
        and lower.x + lower.width >= upper.x + upper.width
        and lower.y + lower.depth >= upper.y + upper.depth
    )

def valid(blocks):
    if len({b.id for b in blocks}) != len(blocks):
        return False
    if any(b.z < 0 or b.width <= 0 or b.depth <= 0 for b in blocks):
        return False
    for i, block in enumerate(blocks):
        if any(overlaps(block, other) for other in blocks[i + 1:] if block.z == other.z):
            return False
        if block.z > 0 and not any(supports(lower, block) for lower in blocks):
            return False
    return True

def add(blocks, block):
    candidate = (*blocks, block)
    return candidate if valid(candidate) else None

def move(blocks, block_id, x, y):
    candidate = tuple(
        Block(b.id, x, y, b.z, b.width, b.depth) if b.id == block_id else b
        for b in blocks
    )
    if not any(b.id == block_id for b in blocks) or not valid(candidate):
        return None
    return candidate

Fungsi valid memeriksa invarians keadaan, sedangkan add dan move hanya mengembalikan kandidat yang lolos pemeriksaan. Model ini mengizinkan satu atau beberapa balok bawah menopang balok atas, tetapi setiap balok atas harus ditutupi penuh oleh satu balok pendukung. Dukungan gabungan dari beberapa balok belum dimodelkan.

Uji invarians dengan test berbasis properti

Test berikut menghasilkan ukuran dan posisi secara otomatis. Properti yang diperiksa: menambah balok dasar yang valid menghasilkan keadaan valid; memindahkan balok dasar tanpa tumpang tindih juga mempertahankan validitas. Jika Hypothesis menemukan kegagalan, ia mencoba menyederhanakan contoh input agar penyebabnya lebih mudah diperiksa.

from hypothesis import given, seed, strategies as st

@seed(20250308)
@given(
    x=st.integers(-20, 20),
    y=st.integers(-20, 20),
    width=st.integers(1, 10),
    depth=st.integers(1, 10),
    dx=st.integers(1, 20),
)
def test_add_then_move_preserves_invariants(x, y, width, depth, dx):
    state = add((), Block(1, x, y, 0, width, depth))
    assert state is not None
    assert valid(state)

    moved = move(state, 1, x + width + dx, y)
    assert moved is not None
    assert valid(moved)
    assert state == (Block(1, x, y, 0, width, depth),)

Simpan test, misalnya sebagai test_tower.py, lalu jalankan:

python -m pip install hypothesis
python -m pytest -q

@seed(20250308) membuat urutan contoh yang dihasilkan dapat diulang selama test dan konfigurasi tidak berubah. Hypothesis juga melaporkan contoh yang gagal; salin contoh tersebut menjadi test regresi tetap jika diperlukan. Saat memakai strategi yang mengandalkan penyusutan contoh atau database Hypothesis, pertahankan artefak dan konfigurasi test yang relevan agar diagnosis tetap mudah.

Perluas properti untuk operasi dan kasus gagal

Test di atas memeriksa jalur valid. Tambahkan properti untuk penolakan operasi yang melanggar aturan, misalnya balok dengan ukuran nol, balok yang bertumpang tindih pada lapisan sama, atau balok atas tanpa penyangga. Pastikan operasi gagal mengembalikan None dan keadaan awal tetap tidak berubah.

  • Tambah: hasil yang diterima harus memiliki ID unik dan memenuhi valid.
  • Pindah: hasil yang diterima harus tetap valid; balok yang tidak ditemukan harus ditolak.
  • Penolakan: masukan tidak valid tidak boleh mengubah susunan asal.
  • Batas geometri: uji tepi yang hanya bersentuhan, ukuran minimum, dan koordinat negatif.

Jangan hanya menguji bahwa valid menerima hasil operasi: bila fungsi operasi dan validator memakai asumsi keliru yang sama, keduanya dapat meloloskan keadaan yang salah. Tambahkan contoh batas yang hasilnya sudah diketahui, dan uji aturan geometri secara terpisah.

Jalankan test di CI sebelum merge

Gunakan perintah test yang sama secara lokal dan di pipeline CI. Contoh langkah untuk pekerjaan CI yang memakai Python:

python -m pip install hypothesis pytest
python -m pytest -q

Jadikan status keluar dari perintah test sebagai syarat pemeriksaan sebelum merge. Kegagalan test harus menggagalkan pekerjaan CI, bukan sekadar menghasilkan laporan. Kunci versi dependensi proyek melalui mekanisme yang sudah digunakan repositori agar hasil CI konsisten dengan pengembangan lokal.

Batas simulasi

Aturan penyangga berbasis cakupan alas hanya validasi geometris diskret. Aturan tersebut tidak menghitung pusat massa, distribusi beban, gesekan, kekuatan material, benturan, getaran, atau ketidakpastian pengukuran. Bahkan susunan yang lolos seluruh test ini belum tentu stabil secara fisik.

Gunakan model untuk menangkap regresi pada aturan perangkat lunak yang memang didefinisikan. Jika aplikasi perlu menilai kestabilan fisik, tentukan kebutuhan tekniknya bersama ahli yang kompeten dan gunakan model mekanika yang sesuai. Hasil test perangkat lunak bukan sertifikasi keselamatan bangunan.