설계에 의한 잘못된 사용
왜 중요한가 API 경계의 버그 대부분은 API 안에 있지 않아요. 괜찮아 보이는 방식으로 썼는데 조용히 잘못된 일을 한 호출자에게 있어요. 모든 호출자를 고칠 수는 없어요. 잘못된 사용을 불가능하게, 또는 시끄럽게 만들 수는 있어요.
API를 쓰는 도우미는 친절한 경향이 있어요: 연결 전에 보내면 대신 연결해 주고, 바이트가 필요한 곳에 문자열을 넘기면 인코딩해 주고, 옵션을 잊으면 기본값이 있어요. 친절 하나하나가 실수를 숨기다가, 그게 멀리 떨어진 곳에서 드러나요.
일찍, 시끄럽게 실패하기: 아무것도 바뀌기 전에, 정확히 잘못된 호출에서, 무엇이 기대됐는지 말하는 메시지와 함께 오류를 일으키기.
도구 넷
- 명시적 상태: 자기가 새것인지, 열렸는지, 닫혔는지 알고, 맞지 않는 호출을 거부하는 객체.
- 불리언 없는 이름 붙은 옵션:
mode="dry_run"은 실수로 다른 플래그와 바뀔 수 없지만,copy(a, b, True, False)는 그럴 수 있어요. - 잘못되면 위험한 선택에는 조용한 기본값 없음: 호출자가 말하게 하세요.
- 뜻을 지닌 타입: 자기 통화를 아는 돈은 다른 통화의 돈과 더해질 수 없어요.
이 모듈에서 숨은 잘못된 사용 스크립트가 API를 잘못 부르고, 아무것도 바뀌지 않은 채 잘못된 호출에서 오류를 기대해요. 올바른 사용 스크립트는 그냥 작동하기를 기대해요. 각 문제는 막아야 할 잘못된 사용을 나열해요.
요약 친절한 짐작은 버그를 숨겨요. 잘못된 사용은 그 잘못된 호출에서, 어떤 효과보다 먼저 거부하세요.
이 연습은 곧 열려요
앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.
이 브라우저가 learn.floati.life의 쿠키를 막고 있어서, 여기서 마친 레슨들이 순서대로 열리지 않아요. 이 사이트의 쿠키를 허용하고 새로고침하세요.