한줄평
“문서 예제도 정식 코드처럼 검사·포맷하려는 오픈소스 프로젝트에 잘 맞습니다. 명령줄 도구라 자동화 파이프라인 밖에서는 활용도가 낮습니다.”
이런 분께 문서 예제까지 린트·테스트하려는 분께
좋은 점
- 문서 속 코드에 기존 개발 도구를 그대로 적용
- CI에 넣어 문서 예제 품질을 자동 관리
아쉬운 점
- CLI 전용이라 수동 사용에는 번거로움
독cmd 소개
문서에 담긴 코드 블록을 꺼내 린터·포매터·테스트 같은 도구를 돌려 주는 명령줄(CLI) 도구입니다. 예를 들어 Markdown이나 reST 문서 안의 파이썬 예제에 black·flake8 등을 그대로 적용할 수 있습니다. 문서 예제의 품질을 코드와 같은 수준으로 관리하려는 CI 워크플로에 어울립니다.
