Teks UUID kanonis
Ubah UUID kanonis huruf kecil menjadi enam belas byte tanpa menyimpulkan versi atau identitas.
import re
UUID_TEXT = re.compile(r"[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}")
def uuid_bytes(text):
if not isinstance(text, str) or not UUID_TEXT.fullmatch(text):
raise ValueError("canonical lowercase UUID required")
return bytes.fromhex(text.replace("-", ""))Tinjau sebelum menerapkan
Bandingkan perilaku sebenarnya dengan hasil yang diharapkan. Jika pemeriksaan gagal, cari penyebabnya sebelum membuat perubahan lain.
Model
Atur endpoint kompatibel OpenAI atau Anthropic dengan URL dasar dan kunci API jika diperlukan. Uji koneksi. Server model lokal harus berjalan; alat jarak jauh dapat mengirim data secara terpisah.
Proyek
Periksa nol dan huruf heksadesimal, lalu tolak huruf besar, kurung, tanda hubung bergeser dan spasi luar.
import re
UUID_TEXT = re.compile(r"[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}")
def uuid_bytes(text):
if not isinstance(text, str) or not UUID_TEXT.fullmatch(text):
raise ValueError("canonical lowercase UUID required")
return bytes.fromhex(text.replace("-", ""))Sepakati representasi pengenal pada batas aplikasi
IdSaffron memberi Anda ruang kerja pemrograman AI Windows untuk memeriksa fungsi batas kecil yang menghubungkan bagian aplikasi lebih besar. Saat penanganan pengenal perlu berubah, jelaskan representasi yang diterima dan harapan kode hilir. Minta model memeriksa validator, langkah konversi, dan pemanggil terkait bersama-sama, agar normalisasi yang tampak sepele tidak diam-diam memperluas kontrak masukan.
Tugas berdasarkan uuid_text.py dapat meninjau penerimaan teks UUID kanonis berhuruf kecil sebelum konversi menjadi byte. Bawa contoh yang berbeda dalam kapitalisasi, pemisah, atau spasi di sekelilingnya, dan nyatakan mana yang harus ditolak. Bahas apakah normalisasi dilakukan sebelum validasi atau pemanggil wajib memberikan bentuk kanonis. Keputusan itu membuat perubahan usulan cukup spesifik untuk ditinjau terhadap kode.
Setelah peninjauan, jalankan pengujian proyek yang memeriksa byte hasil dan representasi yang ditolak. Periksa cara aplikasi melaporkan pengenal tidak valid, termasuk jalur yang sebelumnya menganggap konversi tidak mungkin gagal. IdSaffron terhubung ke endpoint kompatibel OpenAI atau Anthropic yang didukung dengan kredensial bila diperlukan. Opsi model tanpa pembatasan bergantung pada endpoint pilihan Anda; batasan, alat yang tersedia, dan kapasitas konteks tetap menjadi sifat model serta server tersebut. Contoh penerimaan memberi percakapan pemrograman Anda acuan stabil sepanjang revisi.
Batas pengenal yang memerlukan jawaban eksplisit
Haruskah fungsi bantu juga menerima pengenal berhuruf besar?
Putuskan berdasarkan kontrak aplikasi, bukan otomatis menambahkan perilaku permisif. Jika pemanggil mewajibkan teks kanonis berhuruf kecil, menerima bentuk lain dapat menyembunyikan inkonsistensi di hulu. Jika normalisasi dimaksudkan, tentukan tempatnya dan uji representasi hasil.
Apakah pengenal valid membuktikan rekaman ada?
Tidak. Validasi format hanya membuktikan bahwa representasi yang diberikan memenuhi bentuk yang diharapkan. Keberadaan dan otorisasi merupakan pemeriksaan aplikasi terpisah, jadi tinjau pengguna hasil sebelum memperlakukan konversi berhasil sebagai izin mengakses rekaman.
Mengapa memeriksa byte sekaligus teks yang diterima?
Penerimaan saja tidak membuktikan konversi menghasilkan nilai yang diharapkan pengguna hasil. Sertakan pasangan teks dan byte yang diketahui dan verifikasi penanganan hilir, terutama jika usulan mengubah batas serialisasi atau penyimpanan yang dipakai bagian lain proyek.
Bagaimana jika pemanggil sudah memangkas spasi?
Periksa perilaku itu sebelum menduplikasinya. Sepakati apakah fungsi bantu ini menerima masukan ternormalisasi atau melakukan normalisasi sendiri. Tanggung jawab yang jelas mempermudah pemahaman aturan penolakan dan mencegah perlakuan tidak konsisten antarjalur pemanggilan.
IdSaffron · Diperbarui 2026-10-25