Cangkuk Vedro

Vedro menawarkan kebolehlanjutan yang berkuasa melalui sistem pemalamnya, membolehkan anda mencipta penyelesaian yang teguh dan boleh diguna semula yang boleh dikongsi merentas projek dan pasukan yang berbeza. Tetapi bagaimana jika anda hanya bereksperimen dengan pangkalan kod anda, membuat prototaip konsep atau menambah tweak kecil? Menulis pemalam penuh mungkin terasa seperti berlebihan. Di situlah vedro-hooks masuk.

vedro-hooks ialah perpustakaan ringan yang membolehkan anda melampirkan cangkuk tersuai pada pelbagai acara Vedro. Sama ada anda memulakan pelayan olok-olok sebelum ujian dijalankan, melancarkan penyemak imbas untuk ujian hujung ke hujung atau menyediakan pengelogan tersuai, vedro-hooks membolehkan anda menyuntik kefungsian dengan boilerplate yang minimum.

Contoh Praktikal

Andaikan anda ingin mengenal pasti ujian perlahan dalam suite anda — mari kita takrifkan "perlahan" sebagai sebarang ujian yang mengambil masa lebih lama daripada 1 saat untuk dijalankan. Secara tradisinya, anda perlu membuat pemalam tersuai untuk ini. Begini rupanya:

from vedro.core import Dispatcher, Plugin, PluginConfig
from vedro.events import ScenarioFailedEvent, ScenarioPassedEvent

class SlowTestPlugin(Plugin):
    def subscribe(self, dispatcher: Dispatcher):
        dispatcher.listen(ScenarioPassedEvent, self.on_scenario_end)
        dispatcher.listen(ScenarioFailedEvent, self.on_scenario_end)

    def on_scenario_end(self, event: ScenarioPassedEvent | ScenarioFailedEvent):
        elapsed = event.scenario_result.elapsed
        if elapsed > 1.0:
            event.scenario_result.add_extra_details("⚠️ Slow test!")

class SlowTestPluginConfig(PluginConfig):
    plugin = SlowTestPlugin

Pendekatan ini berfungsi, tetapi mencipta pemalam yang lengkap melibatkan lebih banyak persediaan dan pelat dandang tambahan. Ia bagus untuk penyelesaian yang boleh diguna semula tetapi boleh berasa menyusahkan untuk percubaan pantas.

Memudahkan dengan Cangkuk

Dengan cangkuk vedro, anda boleh mencapai fungsi yang sama dengan hanya beberapa baris kod:

from vedro_hooks import on_scenario_passed, on_scenario_failed

@on_scenario_passed
@on_scenario_failed
def highlight_slow_tests(event):
    elapsed = event.scenario_result.elapsed
    if elapsed > 1.0:
        event.scenario_result.add_extra_details("⚠️ Slow test!")

Kod ini menggunakan penghias untuk mendaftarkan fungsi yang akan dipanggil apabila senario lulus atau gagal. Ia menyemak masa berlalu dan menambah butiran tambahan jika senario mengambil masa lebih lama daripada 1 saat.

Scenarios
*
 ✔ retrieve user info (0.52s)
 ✔ retrieve user repos (1.02s)
   |> ⚠️ Slow test!

# 2 scenarios, 2 passed, 0 failed, 0 skipped (1.54s)

Mengurus Cangkuk: Kelemahan dan Penyelesaian

Satu kelemahan menggunakan cangkuk dengan cara ini ialah ia boleh didaftarkan dari mana-mana sahaja dalam projek anda, yang mungkin menjadikannya lebih sukar untuk dijejaki kemudian. Sebaliknya, pemalam dalam Vedro didaftarkan dalam fail vedro.cfg.py, menyediakan lokasi terpusat untuk semua konfigurasi pemalam anda.

Untuk membantu mengurangkan kelemahan cangkuk yang didaftarkan di seluruh pangkalan kod anda, vedro-hooks menyediakan hujah baris arahan --hooks-show. Apabila didayakan, selepas proses ujian selesai, ringkasan semua cangkuk berdaftar bersama lokasi sumbernya akan dipaparkan. Ini berguna untuk nyahpepijat dan mengesahkan cangkuk yang aktif.

Scenarios
*
 ✔ retrieve user repos

# [vedro-hooks] Hooks:
#  - 'highlight_slow_tests' (ScenarioFailedEvent) vedro.cfg.py:26
#  - 'highlight_slow_tests' (ScenarioPassedEvent) vedro.cfg.py:26
# 1 scenario, 1 passed, 0 failed, 0 skipped (0.55s)

Walaupun --hooks-show membantu, anda perlu ingat untuk menggunakannya semasa nyahpepijat. Masih menjadi amalan terbaik untuk mendaftarkan cangkuk anda di lokasi pusat seperti vedro.cfg.py untuk mengekalkan kejelasan dan konsistensi dengan konfigurasi pemalam.

Kesimpulan

vedro-hooks ialah alat yang hebat untuk mempertingkatkan ujian Vedro anda tanpa perlu membuat pemalam tersuai. Ia bersinar apabila anda memerlukan penyelesaian yang cepat dan fokus untuk melanjutkan fungsi. Dengan menggunakannya dengan bijak dan memastikan konfigurasi anda teratur, anda boleh menikmati yang terbaik dari kedua-dua dunia: kesederhanaan dan kebolehselenggaraan.

Atas ialah kandungan terperinci Cangkuk Vedro. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!