Markdown/MDX로 문서 사이트를 구축하고 OpenAPI 및 GraphQL API 문서를 생성하는 TypeScript 문서 프레임워크입니다.
ml-tooling/lazydocs
Sphinx보다 가벼운 대안으로, Google 스타일 Python docstring에서 Markdown API 문서를 생성하는 CLI 도구입니다.
- 스타
- 253
- 포크
- 42
- 열린 이슈
- 3
- 마지막 커밋
- 14일 전
어떤 프로젝트인가요?
Lazydocs는 Python 패키지, 모듈 또는 지정한 클래스와 함수를 검사한 뒤 Google 스타일 docstring을 바탕으로 Markdown 문서를 작성합니다. 명령 하나로 CLI에서 실행하거나, Python에서 프로그래밍 방식 API를 통해 호출할 수 있습니다. 기본 출력 위치는 ./docs 폴더이며, stdout으로 출력할 수도 있습니다.
생성된 파일은 GitHub의 Markdown 렌더러에서 사용할 수 있고 MkDocs 사이트에 포함할 수도 있습니다. 상대 경로나 설정 가능한 기본 URL을 사용해 각 모듈, 클래스, 메서드, 함수에 소스 파일과 줄 번호 링크를 추가할 수 있습니다. 선택적으로 개요 파일을 만들어 모든 모듈, 클래스, 함수를 한곳에 나열할 수도 있습니다.
pydocstyle을 통한 docstring 검증은 선택적으로 활성화할 수 있으며, 문제가 발견되면 문서 생성을 중단합니다. 그 밖에도 비공개 모듈 포함 여부, 목차 및 타임스탬프 워터마크 추가 여부, 출력 형식을 md 또는 mdx로 할지 등을 설정할 수 있습니다.
핵심 기능
- 01Google 스타일 Python docstring에서 Markdown API 문서를 생성합니다.
- 02파일 경로와 줄 번호가 포함된 소스 코드 링크를 만듭니다.
- 03모듈, 클래스, 함수를 나열하는 API 개요 파일을 생성합니다.
- 04MkDocs 사이트 및 GitHub에서 렌더링되는 Markdown과 연동됩니다.
- 05문서 생성 전에 pydocstyle로 docstring을 선택적으로 검증합니다.
활용 사례
- GitHub 저장소와 함께 Python 라이브러리의 API 참조 페이지를 공개합니다.
- MkDocs 문서 사이트에 자동 생성되는 API Reference 섹션을 추가합니다.
- 모듈 작업 중 docstring 기반 문서를 콘솔에 출력합니다.
빠른 시작
- 1
PyPI에서 lazydocs를 설치하세요
pip install lazydocs - 2
Python 패키지의 Markdown 문서를 생성하세요
lazydocs path/to/your/package
사용 전 알아둘 점
- Google 스타일의 Python docstring만 지원합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- lazydocs은(는) 무엇인가요?
- Sphinx보다 가벼운 대안으로, Google 스타일 Python docstring에서 Markdown API 문서를 생성하는 CLI 도구입니다. Lazydocs는 Python 패키지, 모듈 또는 지정한 클래스와 함수를 검사한 뒤 Google 스타일 docstring을 바탕으로 Markdown 문서를 작성합니다. 명령 하나로 CLI에서 실행하거나, Python에서 프로그래밍 방식 API를 통해 호출할 수 있습니다. 기본 출력 위치는 ./docs 폴더이며, stdout으로 출력할 수도 있습니다.
- lazydocs은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- lazydocs은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- lazydocs은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. lazydocs의 마지막 커밋은 2026년 10월 23일입니다.
- lazydocs은(는) 어디에 사용할 수 있나요?
- GitHub 저장소와 함께 Python 라이브러리의 API 참조 페이지를 공개합니다. MkDocs 문서 사이트에 자동 생성되는 API Reference 섹션을 추가합니다. 모듈 작업 중 docstring 기반 문서를 콘솔에 출력합니다.
- lazydocs는 어떻게 설치하나요?
- PyPI에서 lazydocs를 설치하세요: pip install lazydocs Python 패키지의 Markdown 문서를 생성하세요: lazydocs path/to/your/package
- lazydocs은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ml-tooling/lazydocs
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Markdown 파일을 검색 가능한 반응형 정적 문서 사이트로 바꿔주는 MkDocs용 Material Design 테마입니다.
Material for MkDocs 제작팀이 만든 Rust 기반 Markdown 문서용 정적 사이트 생성기입니다.
특별한 설정 없이 모듈, 패키지, docstring에서 Python 3 프로젝트의 API 문서를 자동 생성합니다.
코드베이스의 함수, 클래스, 메서드, 모듈 중 docstring이 작성된 항목의 비율을 측정하고, CI에 적합한 통과·실패 기준을 적용하는 Python CLI입니다.
NumPy 스타일 docstring을 파싱해 구조화된 API 문서로 렌더링하는 Sphinx 확장입니다.