Канонічний текст UUID
Перетворіть канонічний UUID у нижньому регістрі на шістнадцять байтів без висновків про версію чи особу.
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("-", ""))Перевірте перед застосуванням
Порівняйте фактичну поведінку з очікуваним результатом. Якщо перевірка не проходить, з’ясуйте причину перед наступними змінами.
Моделі
Налаштуйте OpenAI-сумісний або Anthropic endpoint із базовою URL-адресою та API-ключем, якщо він потрібен. Перевірте з’єднання. Локальний сервер моделі має працювати; віддалені інструменти можуть окремо передавати дані.
Проєкт
Перевірте нулі та шістнадцяткові літери, відхиляючи верхній регістр, дужки, зміщені дефіси й зовнішні пробіли.
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("-", ""))Узгодьте подання ідентифікаторів на межі застосунку
IdSaffron надає середовище програмування з ШІ для Windows, де можна вивчати невеликі граничні функції, що з’єднують більші частини застосунку. Коли потрібно змінити обробку ідентифікаторів, опишіть допустимі подання й очікування подальшого коду. Попросіть модель разом перевірити валідатор, етап перетворення та відповідний код виклику, щоб нібито нешкідлива нормалізація непомітно не розширила контракт введення.
Завдання на основі uuid_text.py може перевіряти приймання канонічного тексту UUID у нижньому регістрі перед перетворенням на байти. Додайте приклади з іншим регістром, роздільниками чи пробілами навколо й укажіть, які слід відхиляти. Обговоріть, чи нормалізація має передувати валідації, чи код виклику повинен надавати канонічну форму. Ці рішення роблять правку достатньо конкретною для перевірки за кодом.
Після перегляду виконайте тести проєкту, що перевіряють і отримані байти, і відхилені подання. Вивчіть, як застосунок повідомляє про некоректні ідентифікатори, включно зі шляхами, що раніше припускали безвідмовне перетворення. IdSaffron підключається до підтримуваних OpenAI-сумісних кінцевих точок або кінцевих точок Anthropic з обліковими даними, де потрібно. Доступність моделей без обмежень залежить від вибраної кінцевої точки; обмеження, інструменти й місткість контексту залишаються властивостями моделі та сервера. Приклади приймання дають розмові про код сталий орієнтир між редакціями.
Межі ідентифікаторів, що потребують явної відповіді
Чи має допоміжна функція приймати ідентифікатори у верхньому регістрі?
Вирішуйте за контрактом застосунку, а не додавайте поблажливу поведінку автоматично. Якщо код виклику вимагає канонічного тексту в нижньому регістрі, приймання інших форм може приховати неузгодженість вище за потоком. Якщо нормалізація передбачена, визначте її місце й протестуйте отримане подання.
Чи доводить коректний ідентифікатор існування запису?
Ні. Перевірка формату встановлює лише відповідність наданого подання очікуваній формі. Існування та авторизація належать окремим перевіркам застосунку, тому вивчіть споживача, перш ніж трактувати успішне перетворення як дозвіл на доступ до запису.
Навіщо перевіряти байти, а не лише допустимий текст?
Саме приймання не доводить, що перетворення дає значення, очікуване споживачем. Додайте відомі пари тексту й байтів та перевірте подальшу обробку, особливо якщо правка змінює межі серіалізації чи зберігання, використані деінде в проєкті.
Що робити, якщо код виклику вже обрізає пробіли?
Перевірте цю поведінку перед дублюванням. Узгодьте, чи допоміжна функція отримує нормалізовані дані, чи нормалізує їх сама. Явна відповідальність робить правила відхилення зрозумілішими й запобігає неузгодженій обробці різними шляхами виклику.
IdSaffron · Оновлено 2026-10-25