reStructuredText 또는 Markdown 소스에서 HTML, PDF, EPUB 등 다양한 형식의 문서를 생성하는 Python 문서 생성기입니다.
pdoc3/pdoc
특별한 설정 없이 모듈, 패키지, docstring에서 Python 3 프로젝트의 API 문서를 자동 생성합니다.
- 스타
- 1,187
- 포크
- 146
- 열린 이슈
- 111
- 마지막 커밋
- 3개월 전
어떤 프로젝트인가요?
pdoc는 Python 프로젝트의 HTML API 문서를 생성하는 명령줄 도구입니다. 모듈 파일, 패키지 디렉터리 또는 import 경로를 지정하면 공개 객체와 해당 docstring 및 타입 어노테이션을 문서로 렌더링합니다.
Markdown, numpydoc, Google 스타일 등 널리 쓰이는 docstring 형식을 지원하고, LaTeX 수식과 일부 reST 지시문도 처리하며, __all__이 정의되어 있으면 이를 따릅니다. 재정의된 클래스 멤버에 별도 docstring이 없으면 상위 항목의 docstring을 상속하고, AST를 순회해 모듈·클래스·인스턴스 변수를 문서화합니다. 식별자 간 링크도 자동으로 생성합니다.
템플릿으로 출력 형식을 사용자 지정할 수 있으며, 모듈 수준의 __pdoc__ 딕셔너리로 docstring을 재정의할 수 있습니다. 내장 개발용 웹 서버에서 문서를 렌더링한 결과를 편집 중에 미리 볼 수 있습니다.
핵심 기능
- 01모듈, 패키지 디렉터리 또는 import 경로에서 HTML 문서를 생성합니다.
- 02Markdown, numpydoc, Google 스타일 docstring을 지원합니다.
- 03PEP 484 및 PEP 526 타입 어노테이션을 처리합니다.
- 04재정의된 클래스 멤버의 docstring을 상속합니다.
- 05참조된 식별자에 자동으로 링크를 연결합니다.
- 06사용자 지정 템플릿과 내장 실시간 미리보기 서버를 지원합니다.
활용 사례
- Python 라이브러리의 API 레퍼런스 문서를 공개합니다.
- 추가 설정 없이 내부 Python 패키지를 둘러볼 수 있는 문서로 생성합니다.
- 문서를 작성하면서 docstring 렌더링 결과를 미리 확인합니다.
빠른 시작
- 1
PyPI에서 pdoc3 설치하기
pip install pdoc3 - 2
프로젝트 문서 생성하기
pdoc your_project
사용 전 알아둘 점
- PyPI 패키지 이름은 pdoc가 아니라 pdoc3이므로, pdoc3라는 이름으로 설치해야 합니다.
- AGPL-3.0 라이선스가 적용됩니다. 강한 카피레프트 라이선스이므로 비공개 소스 프로젝트에서의 사용이 제한될 수 있습니다.
포함된 컬렉션
토픽
자주 묻는 질문
- pdoc은(는) 무엇인가요?
- 특별한 설정 없이 모듈, 패키지, docstring에서 Python 3 프로젝트의 API 문서를 자동 생성합니다. pdoc는 Python 프로젝트의 HTML API 문서를 생성하는 명령줄 도구입니다. 모듈 파일, 패키지 디렉터리 또는 import 경로를 지정하면 공개 객체와 해당 docstring 및 타입 어노테이션을 문서로 렌더링합니다.
- pdoc은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- pdoc은(는) AGPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- pdoc은(는) 아직 유지보수되고 있나요?
- 6개월 이내 업데이트. pdoc의 마지막 커밋은 2026년 8월 15일입니다.
- pdoc은(는) 어디에 사용할 수 있나요?
- Python 라이브러리의 API 레퍼런스 문서를 공개합니다. 추가 설정 없이 내부 Python 패키지를 둘러볼 수 있는 문서로 생성합니다. 문서를 작성하면서 docstring 렌더링 결과를 미리 확인합니다.
- pdoc는 어떻게 설치하나요?
- PyPI에서 pdoc3 설치하기: pip install pdoc3 프로젝트 문서 생성하기: pdoc your_project
- pdoc은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pdoc3/pdoc
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
빌드 과정 없이 Markdown 파일을 웹사이트로 만드는 문서 사이트 생성기입니다.
Markdown/MDX로 문서 사이트를 구축하고 OpenAPI 및 GraphQL API 문서를 생성하는 TypeScript 문서 프레임워크입니다.
여러 개발자 레퍼런스 문서를 검색 및 오프라인 사용이 가능한 하나의 웹 기반 API 문서 브라우저로 제공합니다.
OpenAPI, Swagger, AsyncAPI 또는 GraphQL 정의로 반응형 3단 API 레퍼런스 사이트를 생성하는 오픈소스 도구입니다.
Python 패키지의 구조와 시그니처를 추출해 API 문서를 생성하거나 호환성을 깨는 변경을 감지하는 도구입니다.