설계 결정
토파즈 6.0의 규칙은 하나하나의 결정에서 나왔습니다. 결정마다 어떤 문제를 풀려 했는지, 무엇으로 정했는지, 검토하고 버린 대안이 무엇이었는지 적어 둡니다. 결정에 딸린 예제에는 기대 결과를 함께 적습니다.
어휘와 리터럴
- 줄바꿈 형식이 문장 경계를 바꾸지 않습니다
소스의 LF, CRLF, 단독 CR은 같은 줄바꿈으로 읽습니다.
- 블록 주석처럼 보이는 코드는 연산자 규칙으로 진단합니다
/는* /와*두 토큰입니다. - 주석은 한 줄씩 씁니다
주석은
/로 시작해 그 줄 끝까지 이어집니다./ - 문장은 줄바꿈으로 나누고 값은 명시적으로 버립니다
문장을 줄바꿈으로 나눕니다.
- 이름은 NFC로 적습니다
식별자는 Unicode 16 NFC 원문으로 적습니다.
- 진법 접두사와 16진 숫자는 소문자로 씁니다
2진수의
0b와 16진수의0x는 소문자로 씁니다. - 시간 길이는 밀리초로 표시하고 넘침을 알립니다
Duration은 더하기, 빼기, 양쪽 순서의 정수 곱, 비교, 표시,to를 지원합니다.Millis() - 모든 템플릿 태그는 같은 이스케이프를 씁니다
모든 템플릿 태그에서 같은 이스케이프 문법을 씁니다.
- 파일의 줄바꿈 형식은 문자열 값을 바꾸지 않습니다
문자열 리터럴에 적힌 LF, CRLF, 단독 CR을 모두 같은 개행 하나로 읽습니다.
- 경로는
Path.으로 만듭니다from p태그를 없앱니다. - 공백뿐인 소스 줄은 문자열에서 빈 줄이 됩니다
공백과 탭만 있는 소스 줄에서는 들여쓰기를 지우고 개행을 남깁니다.
- 문자열 보간과 파생
Show는 유한 실수를 지수 없이 적습니다문자열 보간과 파생 표시에서, 유한 비영값은 같은 binary64로 돌아오는 가장 짧은 가수의 십진수를 고릅니다.
- 경로를 만드는 이름은
Path.하나입니다from 문자열에서 경로를 만들 때
Path.을 씁니다.from
바인딩과 타입
- 바인딩의 타입은 한 곳에만 적습니다
바인딩 주석과 패턴 주석을 같은 바인딩에 함께 쓰면 거절합니다.
- 생성자와 충돌하는 이름은 값 이름으로 쓸 수 없습니다
값을 담지 않는 변형도
Choice.로 씁니다.Empty() - 값 변경 오류는 원인에 맞는 진단을 냅니다
검사에서 불변 뿌리를 바꾸면 TPZ5003입니다.
- 선택적 접근을 거쳐 바꾸는 값도 가변 바인딩에서 시작합니다
?.가 들어 있는 저장 경로도 뿌리를 추적합니다. - 블록 안의 함수 이름은 블록 전체에서 같은 선언을 가리킵니다
블록 안의
function선언은 그 블록 전체에서 같은 이름의 바깥 값을 가립니다. - 초기화 전 읽기는 평가 경계에 따라 진단합니다
조건이나
match대상처럼 즉시 평가하는 식의 초기화 전 읽기는 이름 해석 단계 TPZ3018입니다. - 패턴 안의 식은 패턴을 시험할 때 평가합니다
검사할 값을 만드는 식(
let,if let,while let의=오른쪽,match대상,for의 반복 대상)은 둘러싼 식과 같은 때 평가합니다. - 이름은 검사와 실행에서 같은 선언을 가리킵니다
이름을 쓴 자리마다 그 역할에 맞는 대상이 하나로 정해지고, 검사와 실행이 같은 대상을 씁니다.
- 호출 대상을 감싼 괄호는 상수식 판정을 바꾸지 않습니다
호출 대상에 괄호를 붙이거나 빼도
const초기값으로 허용되는지는 같습니다. - 컬렉션 대입과 전달은 독립된 값을 만듭니다
배열, 맵, 집합은 값입니다.
- 변경 메서드를 나중에 부를 때 람다로 씁니다
let add = xs.처럼 변경 메서드를 값으로 떼어 내면 검사 단계에서 거절합니다.push - 임시 값의 변경 호출은 결과를 사용해야 합니다
뿌리 바인딩이 없는 값에서 변경 메서드를 호출하고 결과를 버리면 검사 단계에서 거절합니다.
- else 없는 if는 언제나 단위 값을 돌려줍니다
else가 없는if는 값이 필요한 자리에서도()를 돌려줍니다. - 맵의 기본값은
get과??로 씁니다기본값은
m.으로 씁니다.get(k) ?? fallback
식, 패턴, 제어 흐름
- 양의 값은 단항 더하기 없이 씁니다
단항
+를 없앱니다. - 배열과 집합과 범위의 원소 포함은
in으로 씁니다배열, 집합, 범위에 원소가 있는지는
in으로 확인합니다. - 값이 없으면 선택적 메서드 호출의 인수도 건너뜁니다
받는 값을 한 번 평가합니다.
- 데이터 흐름을 일반 호출과 바인딩으로 씁니다
|>,>>와 식 자리에 쓰는_를 없앱니다. - 제어문에 들어가는 식은 괄호로 감쌉니다
if (test),match (value),while (test)처럼 제어 입력과 조건을 괄호로 감쌉니다. - 피연산자는 왼쪽부터 평가합니다
이항식과 그 안의 피연산자를 왼쪽에서 오른쪽으로 평가합니다.
- 쓰기 대상은 우변과 인수를 평가한 뒤 정합니다
색인 대입과 변경 메서드는 우변이나 인수의 평가를 끝낸 뒤 현재 바인딩의 값에 씁니다.
- 숫자 패턴은 음수 리터럴도 받습니다
숫자 리터럴 패턴 앞에는 단항
-하나를 붙일 수 있습니다. - 레코드 패턴은 필드 이름과 하위 패턴을 함께 씁니다
레코드 패턴의 각 필드는
field: pattern으로 씁니다. - 레코드 패턴에서 빠진 콜론은 구문 오류입니다
TPZ5611은 내부 방어용으로 예약합니다.
- 갈래에서 함수의 값을 돌려줄 때 블록을 씁니다
갈래에서
return을 쓸 때는 블록 안에 넣습니다. - 먼저 맞는 갈래를 고르고 가려진 갈래는 거절합니다
match는 소스 순서로 시험하고 패턴과 조건이 처음으로 함께 맞는 갈래를 고릅니다. - 리터럴로 쓴 빈 범위 패턴은 검사에서 거절합니다
두 끝값이 정수 리터럴인 패턴은 먼저 일반 리터럴 검사를 합니다.
- 계산한 끝값은 범위 패턴을 시험할 때마다 평가합니다
범위에 닿으면 계산한 아래 끝값을 평가한 뒤 위 끝값을 평가합니다.
- 나머지를 받을 때도 하위 패턴을 씁니다
.뒤에는 항상 패턴을 씁니다.. - 인수가 없는 생성자도 괄호를 씁니다
값과 패턴 모두에서
None(),Empty(),Some(x)처럼 생성자에 괄호를 씁니다. match는 가능한 값을 모두 다룹니다모든
match는 검사 단계에서 가능한 값을 빠짐없이 다뤄야 합니다.- 반복은 효과를 실행하고 컴프리헨션은 값을 모읍니다
for는 모든 문맥에서 효과를 실행하고()를 돌려줍니다. - defer 진단은 블록을 쓰라고 안내합니다
구문 분석 단계의 TPZ2004는
defer에 블록이 필요하다고 말하고 본문 식의 시작을 가리킵니다. - 나중에 실행할 코드는 defer 블록에 넣습니다
defer뒤에는 블록을 씁니다. - 제어 이동은 defer 본문 경계를 넘을 수 없습니다
return,break,continue,?가defer본문을 넘어가면 도달 가능성과 상관없이 해당 식에 검사 단계 TPZ5001을 냅니다. - 오류값을 반환하며 나갈 때도 등록한 정리를 실행합니다
?가Err를 돌려주며 벗어나는 범위의defer는 등록한 역순으로 실행합니다. - 복구할 수 없는 실행 오류가 나면 남은 정리는 실행하지 않습니다
일반 실행 오류는 잡아서 계속할 수 없는 종료입니다.
함수와 제네릭
- 람다의 매개변수는 하나여도 괄호를 씁니다
람다의 매개변수 목록을 항상 괄호로 감쌉니다.
- 가변 길이 매개변수에는 기본값을 쓰지 않습니다
가변 길이 매개변수에 기본값을 쓰면 거절합니다.
- 타입 매개변수의 능력은 프로토콜로 드러냅니다
타입 매개변수나 불투명한 투영에는 정적 멤버 계약 없이 점으로 필드를 읽거나 메서드를 부를 수 없습니다.
- 호출은 위치 인수를 쓰고 독립 옵션은 레코드로 넘깁니다
호출은 위치 인수로 씁니다.
- 명시적 타입 인수는 호출 이름이나 멤버 바로 뒤에 씁니다
명시적 타입 인수는 이름이나 멤버 접근 뒤에 씁니다.
- 타입 인수와 호출 괄호 사이는 띄어도 됩니다
이름이나 멤버 뒤에서
<와>안이 타입 목록의 꼴이고 다음 토큰이(이면 명시적 타입 인수 호출입니다. - 유니온 호출의 인수는 모든 갈래에서 타입 하나를 갖습니다
독립 인수로 각 갈래의 서명을 먼저 정합니다.
- 매개변수 이름은 같은 목록에서 한 번만 씁니다
이름 있는 함수와 람다의 한 매개변수 목록에서 같은 이름이 반복되면 거절합니다.
구조
- 십진 반올림 방식은 일반 열거형입니다
Rounding는 일반 열거형이며 변형은 여섯 개입니다.Mode - 열거형의 값에는 열거형을 포함한 합집합도 넣을 수 있습니다
열거형을 포함한 합집합도 변형의 페이로드 타입으로 허용합니다.
- 열거형 변형은 표준 생성자와 같은 이름을 쓸 수 있습니다
열거형 변형에
None,Some,Ok,Err를 쓸 수 있습니다. - 구조적 레코드 갱신에서는 필드마다 한 번만 씁니다
구조적 레코드 갱신에서 반복한 필드 이름을 거절합니다.
- 생성자는 값 자리에서도 인자 목록을 씁니다
생성자는 값 자리에서
Name(arguments)로 씁니다. - 프로토콜 안의 구현 타입은
Self로 씁니다프로토콜 선언 자체는 타입 매개변수를 받지 않습니다.
- 프로토콜 서명은 일반 함수의 선언 규칙을 씁니다
일반 함수처럼 타입 매개변수, 가변 길이 매개변수, 기본값을 쓸 수 있습니다.
- 프로토콜 구현은 선언의 기본값과 공개 범위를 따릅니다
구현 메서드는 제네릭과 가변 인수를 쓸 수 있고 반환 주석을 생략할 수 있습니다.
- 가져온 타입의 프로토콜 가시성은 구현 방식과 무관합니다
수동 구현과 파생 구현은 가져오기에서 같은 가시성을 따릅니다.
- 직접 구현한 JSON도 encode와 decode를 씁니다
직접 구현한 JSON 프로토콜에는 일반
encode와decode메서드를 씁니다. - using은 정상 종료와 구조적 조기 종료에서 정리합니다
using의 정리는 정상 종료와 구조적 조기 종료에서 실행됩니다. - 파생 구현은 안쪽 타입의 프로토콜 구현을 호출합니다
파생 구현은 안쪽 타입의 수동 또는 파생 구현을 부릅니다.
- 새 명목 타입도
derives를 명시합니다newtype도 레코드나 열거형처럼 필요한 프로토콜을derives로 명시합니다. - 동등성, 순서, JSON 변환은 각 연산의 조건을 따릅니다
Map과 Set의
Eq는 포함되는 항목을 기준으로 합니다. - 프로토콜은 일반 모듈 이름 규칙을 따릅니다
일반적인 내보내기, 가져오기, 이름 해석 규칙을 프로토콜에도 적용합니다.
- 제네릭 프로토콜 구현의 제약은 앞쪽 매개변수에 씁니다
impl<T: Eq> Eq<Box<T>>처럼 제약을 앞쪽 매개변수 목록에 씁니다. - 제네릭 프로토콜 구현은 함수와 같은 제약 문법을 씁니다
프로토콜 구현은 명시적 제네릭 매개변수와 제약을 가질 수 있고, 조건부로 구현하거나 자동 생성할 수 있습니다.
- 컬렉션은 만드는 자리의 기대 타입을 따릅니다
배열, 집합, 맵과 컴프리헨션에 기대 타입을 같은 규칙으로 전달합니다.
- 콜백 메서드는 변환을 잇고 컴프리헨션은 원천을 모읍니다
arr.처럼 함수를 이어 붙이는 콜백과, 필터와 여러 원천을 묶어 결과를 만드는 컴프리헨션을 모두 둡니다.map(f) - 배열과 집합과 범위에 같은 콜백 메서드를 씁니다
배열, 집합, 범위에 즉시 평가하는
map,filter,reduce를 제공합니다. - 맵과 집합은 삽입 순서를 보존합니다
맵의 키, 값, 항목, 순회와 표시는 삽입 순서를 따릅니다.
실패, 동시성, 모듈
- Result의 오류 타입이 정해지지 않으면 주석을 씁니다
오류 타입을 추론하지 못하면 검사 단계의 TPZ5022와 함께 타입 주석을 요구합니다.
- 콜백의 오류값은 콜백에서 반환합니다
람다와 콜백의
?는 그 호출에서Result나Option을 반환합니다. - 갈래가 없는 동시 실행은 빈 레코드를 돌려줍니다
갈래가 없는
concurrent는 빈 레코드를 돌려줍니다. - 시간 제한은 Duration 식을 한 번 평가합니다
시간 제한은 일반
Duration식입니다. - 완료와 제한 시간이 겹치면 제한 시간이 우선합니다
제한 시간에 닿은 순간과 완료가 겹치면 시간 초과가 우선합니다.
- 동시 실행의 갈래는 바깥 함수나 반복문으로 이동하지 않습니다
갈래 밖의 함수나 반복문을 대상으로 하는 반환, 반복 제어, 오류 전파는 정적으로 거절합니다.
- 시간 제한 그룹은 끝나지 않는 갈래가 있어도 대체 결과로 끝납니다
시간 제한을 넘기면
concurrent그룹은 대체 경로로 끝납니다. - 시간 제한으로 중단된 갈래는 사용자 정리를 실행하지 않습니다
마감으로 중단된
concurrent갈래는 남은defer코드와using정리를 실행하지 않습니다. - 모듈 어디서나 같은 문장 규칙을 씁니다
진입 파일과 가져온 파일에 같은 최상위 문장 규칙을 씁니다.
- 컴파일러가 만든 이름은 사용자 코드에서 쓸 수 없습니다
컴파일러가 만든 선언은 사용자 코드가 이름으로 쓸 수 없습니다.
- 공개 let은 일반 패턴으로 이름을 묶습니다
export let은 일반 불변let의 패턴으로 바인딩하고 그 이름을 모두 공개합니다. - 공개 선언은 해석된 타입으로 검사합니다
공개 표면에서 해석된 타입을 검사합니다.
- 레코드의 기본값도 공개 이름의 경계를 따릅니다
레코드 기본값의 이름 접근에 일반 모듈 가시성 규칙을 적용합니다.
- as는 가져온 이름이 실제로 바뀔 때만 씁니다
as로 기본 이름을 그대로 반복하면 TPZ2009로 거절합니다. - 가져온 값의 바인딩은 수정할 수 없습니다
가져온 값의 바인딩은 불변입니다.
표준 라이브러리
- 호스트의 읽기와 닫기와 쓰기는 다른 실행 오류입니다
입력은 실행 단계의 TPZ4008, 닫기는 TPZ4009, 출력은 TPZ4010으로 구별합니다.
- 줄 출력은 단위 값을 돌려주고 호스트 쓰기 실패는 실행 오류입니다
std.의 서명은 단위 값을 유지합니다.io. write Line - 호스트 출력 오류는 실패한 출력 호출을 가리킵니다
write의 호스트 쓰기 실패에 전용 실행 오류를 쓰고 진단 위치를 그 호출로 둡니다.Line - 길이와 키와 값 조회는 프로퍼티로 씁니다
컬렉션에서
length,keys,values조회는 프로퍼티를 씁니다. - 빈 컬렉션은
length == 0으로 확인합니다빈 값은
length == 0으로 판정합니다. - 바이트 슬라이스의 경계를 벗어나면 실행 오류가 납니다
슬라이스는 끝을 포함하지 않으며
0 <= start <= end <= length이어야 합니다. - 바이트의 16진 입력은 소문자 두 자리씩 읽습니다
각 바이트를 소문자 16진 숫자 두 자리로 읽습니다.
- 압축 해제는 스트림 하나를 끝까지 읽습니다
형식이 정한 스트림, 프레임 또는 멤버 하나를 끝까지 소비합니다.
- 압축 해제에 출력 바이트 한도를 지정할 수 있습니다
압축 해제 함수는 선택 인자
max를 받습니다.Bytes - 경로 연산은 정규화한 텍스트를 기준으로 합니다
정규화한 경로의 구성 요소만 사용합니다.
- 정규식은 ASCII 글자와 숫자만 이스케이프 이름으로 남깁니다
백슬래시 뒤의 ASCII 글자와 숫자만 이스케이프 이름으로 예약합니다.
- 정규식 이름 캡처는 한 가지 표기를 씁니다
Unicode 16.0 정규식 문법의 단순 대소문자 접기를 씁니다.
- 정규식은 크기 한도를 넘으면 컴파일에서 거절합니다
컴파일에서는 명령어 65536개, 프로그램 크기와 캡처 칸 수의 곱
2^22, 그룹 중첩 깊이 128을 한도로 둡니다. - 정규식 반복은 빈 일치를 한 번 더 수행하지 않습니다
더 진행하지 않는 빈 반복을 추가하지 않습니다.
- 검색과 분할과 치환은 같은 일치 순서를 씁니다
왼쪽에서 첫 일치를 선택해 겹치지 않는 순서로 이어 갑니다.
- 정규식의 일치 위치는 UTF-8 바이트로 셉니다
Match.와start Match.는 UTF-8 바이트 위치입니다.end - 정규식의 치환은 중괄호로 캡처를 가리킵니다
0번 캡처는 일치한 전체 문자열입니다.
- URL은 WHATWG 규칙을 따릅니다
기준 URL 없이 WHATWG의 절대 URL 파싱과 직렬화를 따릅니다.
- 국제화 도메인 이름은 Unicode 16.0.0을 기준으로 처리합니다
국제화 도메인의 UTS 46 처리는 Unicode 16.0.0 표를 씁니다.
- 날짜는 서기 1년부터 9999년까지입니다
전향적 그레고리력
0001-부터01- 01 9999-까지를 받습니다.12- 31 - 큰 정수의 텍스트는 진법을 정하고 소문자로 씁니다
2부터 36까지의 진법과 소문자 ASCII 숫자를 씁니다.
- 십진수 곱셈은 정규화한 결과의 자릿수를 검사합니다
십진수는 임의 정밀도 정수 계수와 정규화한 자릿수 0부터 4294967295를 씁니다.
- 십진수 읽기는 ASCII 입력 전체를 확인합니다
ASCII 십진수 전체를 읽습니다.
- 십진 반올림은 방향과 동점 규칙을 드러냅니다
여섯 반올림 방식을 제공합니다.
- 십진 나눗셈은 정확한 몫을 한 번만 반올림합니다
정확한 몫을 요청한 자릿수에서 한 번 반올림합니다.
- 십진수의 정수 변환은 정확할 때만 값을 돌려줍니다
int.은 정확합니다.to Decimal - 십진수는 정확한 수치 값으로 비교합니다
수치 값 그대로 동등성과 순서를 정합니다.
- 파일 시스템 함수는 바이트와 목록 순서를 보장합니다
바이트를 그대로 보존합니다.
- main이 받는 표준 입력은 한 번만 소비됩니다
main(args, stdin)을 쓰면 실행기가 표준 입력을 끝까지 읽어stdin으로 넘깁니다. - 파일 스트림은 기존 파일을 열고 위치와 닫힘 상태를 공유합니다
기존 일반 파일을 읽고 쓸 수 있게 엽니다.
- JSON의 null은 kind로 확인합니다
JSON을 없애고Value. is Null() value.을 씁니다.kind() == "null" - JSON 숫자는 원래 표기를 보존합니다
JSON 숫자의 원문 철자를 정확히 보존합니다.
- JSON 파서는 문서 전체를 읽고 중복 키를 거절합니다
완전한 문서 하나를 읽고 디코딩한 키가 중복되면 거절합니다.
- JSON 쓰기는 객체 키를 정렬합니다
JSON 프로토콜 호출은 한 번만 수행합니다.
- 이름으로 읽는 CSV는 중복 헤더를 거절합니다
이름 기반 CSV 읽기는 헤더가 중복되면 오류를 반환합니다.
- 헤더를 지정한 CSV 쓰기는 중복 열을 오류로 돌려줍니다
stringify는With Header Result<string, string>을 반환하고 요청에 중복 열 이름이 있으면 오류를 돌려줍니다. - TOML은 윤초를 받고 중첩을 128까지 허용합니다
RFC 3339에 따라 초 값 60을 받습니다.
- TOML은 1.0 문법을 쓰고 JSON 변환 오류를 반환합니다
TOML 1.0 형식을 읽고 최상위 테이블을 결정적인 순서로 씁니다.
- 테스트 반복은 일반 for를 씁니다
for와All Int for을 없애고 일반All Bool for를 사용합니다. - 파서 검색은 유니코드 스칼라 위치를 씁니다
정수를 받는 ASCII 판정 함수는 모든 정수 입력에 결과를 돌려줍니다.
- 격자 포인트로 변환하는 메서드는
to입니다Scaled Points scaled대신Points to를 씁니다.Scaled Points - 조판의 공개 물리 거리는
Length<Pt>입니다std.의 공개 물리 거리는typeset Length<Pt>로 씁니다. - 한중일 클러스터 분류의 이름은
Cjk입니다Cluster Korean를 실제 분류 범위를 나타내는Cluster Cjk로 바꿉니다.Cluster - 빈 마지막 줄에도 52퍼센트 기준을 적용합니다
마지막 줄이 52퍼센트 미만인지 글자 수가 0이어도 검사합니다.
- 줄 비용 함수의 이름은
line입니다Badness line의 이름을Badness Mpt line로 바꿉니다.Badness - 최대 자간은 글꼴에 상대적인 길이로 씁니다
max은Letter Spacing Em Length<Em>을 받습니다. - 같은 조판 조건에서는 같은 줄 경계를 고릅니다
입력 순서, 정책, 계산 격자, 제품 판이 같으면 줄 경계와 종류, 너비와 비용, 오류 종류가 같습니다.
- 줄바꿈 분류와 문단 계획은 서로 다른 경계를 다룹니다
classify는 저장한 포인트 틱으로 비교합니다.Breaks - 빈 조판 입력은 빈 결과로 성공합니다
다른 조건이 유효하면 빈 클러스터 배열과 빈 문단은 빈 결과로 성공합니다.
- 비어 있지 않은 문단은 마지막 셰이핑 경계를 허용해야 합니다
비어 있지 않은 입력의 마지막 셰이핑 경계는 모든 규칙 묶음에서 허용되어야 합니다.
- 문단 계획은 탐색 범위와 두 결과를 명시합니다
FixedPoint는 앞선 후보 80개부터 탐색을 넓힙니다.
- 조판은 음수 물리 너비를 거절하고 음수 자간은 허용합니다
음수 물리 크기, 페널티 너비, 드롭캡 안쪽 여백은 거절합니다.
- 선택한 페널티의 너비는 줄 너비에 포함됩니다
선택된 페널티의 너비는 모든 종류와 두 계산 방식에서 반영하며 정렬할 때의 자연 너비에도 넣습니다.
- 최소 마지막 줄 너비는 마지막 FixedPoint 줄에만 적용합니다
min은 마지막 FixedPoint 줄만 계산할 때 씁니다.Final Line Width Ratio M - 소비자 산출물은 inspectConsumerArtifact로 확인합니다
inspect만 제공하고 같은 동작의Consumer Artifact verify를 없앱니다.Consumer Artifact - 리스펙스 평가와 사용 검증과 증거 작업은 별도 호출입니다
6.0 API는 표준 평가와 사용 검증, 호스트 중단, 추가 증거 작업을 구별합니다.
- 리스펙스 요청은 식별한 뒤 불변 값으로 보관합니다
표준 바이트 교환과 호스트 Datum 생성은 명시적 변환 예산 안에서 정확한 값을 보존합니다.
- 리스펙스 패키지는 검증을 끝낸 뒤 사용할 수 있습니다
공급된 구성요소 전체와 자원 계약을 검증한 뒤 사용할 수 있는 패키지 핸들을 돌려줍니다.
- 리스펙스 규칙은 준비 뒤에도 전송된 출처를 다시 검증합니다
준비는 자체 유한 예산으로 검증된 불변 규칙을 만듭니다.
- 리스펙스는 평가 결과와 시도 오류를 구별합니다
평가가 끝나면 표준 평가 결과를 돌려줍니다.
- 리스펙스는 요청과 출처와 실행 파일을 서로 다른 식별자로 다룹니다
의미 요청, 소스 출처, 엔진 바이트, 프로파일의 호스트 작업에는 각각 다른 타입의 식별자를 씁니다.
- 리스펙스 재실행은 보관한 평가 결과를 다시 대조합니다
fresh는 보관된 요청을 실행 전에 검증하고 새 평가 결과가 기록과 같을 때 성공합니다.Replay - 리스펙스 평가 결과는 후속 검증과 별도로 남습니다
평가 결과는 보존하고 프로파일 자격, 산출물 검증, 발급자 인증을 따로 보고합니다.
- 리스펙스의 단계마다 유한한 자원 한도가 있습니다
준비, 평가, 호스트 작업은 각자 완전한 유한 한도 레코드를 씁니다.
- 리스펙스 팩터리도 일반 규칙을 만듭니다
생성된 팩터리는 검증된 잠금 항목과 명시적 준비 한도를 사용해 표준 불변 규칙을 만듭니다.
- 문자열은 글자 단위로도 나눌 수 있습니다
string.는 Unicode 16의 글자 단위 경계 규칙에 따라 문자열을 배열로 나눕니다.graphemes() - 문자열과 배열의 기존 내장 멤버 서명을 이어갑니다
별도 결정으로 삭제하거나 이름을 바꾼 경우를 제외하고 5.21 내장 멤버의 서명을 유지합니다.
- 문자열 정수 변환은 ASCII 숫자와 앞의 빼기 기호를 받습니다
string.는 ASCII 10진 숫자 앞에 선택적인to Int() -만 허용합니다.
도구
- 지연 작업이 실패하면 명령도 실패합니다
지연 작업의 실행 오류나 호스트 오류는 전체 실행을 실패시키며
test-를 보고하지 않습니다.ok - 테스트 단언은 한 번 평가하고 기준 파일을 정확히 비교합니다
인수를 왼쪽에서 오른쪽으로 한 번만 평가합니다.
- 저장소 정리는 사용 중일 수 있는 작업 공간을 보존합니다
소유자가 살아 있거나 확실히 판단할 수 없으면 작업 공간의 나이와 관계없이 보존합니다.
- 동작이 없는 명령 옵션을 없앱니다
-처럼 동작을 바꾸지 않는 옵션을 없앱니다.- types - 판 번호는
topaz version으로 확인합니다판 번호 조회는
topaz version을 씁니다. - 명령의 옵션 값은 별도 인자로 줍니다
값이 필요한 옵션에는 다음 인자로 값을 줍니다.
- 같은 명령 옵션은 한 번만 줍니다
같은 옵션을 두 번 주면 값이 같아도 거절합니다.
- 명령의 JSON 출력은
-으로 고릅니다- format json JSON을 출력하는 명령에는
-을 씁니다.- format json - JSON 진단은 코드와 원인 위치를 안정적으로 제공합니다
-은 구조화된 진단 정체성, 필수 필드와 타입, 좌표 단위, 심각도, 주 위치가 가리키는 원인을 계약으로 둡니다.- format json - 도움말은
topaz help로 엽니다topaz help로 도움말을 요청합니다. - 의존성 소스를 가져오는 명령은
vendor입니다vendor를 쓰고 같은 동작을 하는fetch는 없앱니다. - 의존성 선언은 테이블로 씁니다
의존성 선언은 테이블로 씁니다.
진단
- 블록 주석 진단 TPZ0002는 퇴역하고 코드가 남습니다
6.0.0에서 TPZ0002를 퇴역하고 번호, 의미, 문서 주소를 보존합니다.
- 호출 깊이는 실행 중인 사용자 호출을 셉니다
TPZ5009의 호출 깊이에는 이름 있는 함수, 람다, 사용자 콜백, 프로토콜과 수신자 메서드를 셉니다.
아직 규칙이 없는 결정
- 타입 판정은 실패한 사실에 의존하는 부분만 보류합니다
검사 단계에서 처음 실패한 구체적 의무마다 원인 진단을 한 번 냅니다.
- 제네릭 함수의 다형성은 바인딩에 남습니다
주석 없는 적격 바인딩은 함수의 제네릭 서명을 보존합니다.
- 표준 라이브러리 생성자와 비용 계산 오류는 공개 호출 자리를 가리킵니다
표준 라이브러리 생성자와 비용 계산의 실행 오류는 사용자가 쓴 공개 호출을 주 위치로 가리킵니다.