특별한 설정 없이 모듈, 패키지, docstring에서 Python 3 프로젝트의 API 문서를 자동 생성합니다.
numpy/numpydoc
NumPy 스타일 docstring을 파싱해 구조화된 API 문서로 렌더링하는 Sphinx 확장입니다.
- 스타
- 354
- 포크
- 184
- 열린 이슈
- 135
- 마지막 커밋
- 6일 전
어떤 프로젝트인가요?
numpydoc은 NumPy 문서 형식으로 작성된 docstring을 처리하는 Sphinx 확장입니다. Parameters, Returns, Raises, Examples 같은 섹션을 형식에 맞는 Sphinx 출력으로 변환하므로, Python 프로젝트 전체에서 일관된 docstring 스타일을 유지할 수 있습니다.
이 확장은 docstring 파싱 외에도 NumPy 스타일로 함수와 C API를 문서화하는 np:function 및 np-c:function 같은 코드 설명 지시문을 제공합니다. 프로젝트에 포함된 NumPy docstring 가이드에서는 확장과 함께 사용할 수 있는 docstring 작성법을 설명합니다.
이 패키지를 사용하려면 Python 3.10 이상과 Sphinx 6 이상이 필요합니다.
핵심 기능
- 01Parameters, Returns, Raises 같은 NumPy 스타일 docstring 섹션을 파싱합니다.
- 02코드 객체를 문서화하는 np:function 및 np-c:function 지시문을 추가합니다.
- 03표준 확장으로 Sphinx와 통합됩니다.
활용 사례
- NumPy 스타일 docstring을 사용하는 Python 라이브러리의 API 레퍼런스 문서를 생성합니다.
- Python API와 함께 np-c 지시문을 사용해 C 확장 함수를 문서화합니다.
사용 전 알아둘 점
- 저장소 메타데이터에서 라이선스를 확인할 수 없습니다. 재사용하기 전에 LICENSE 파일을 확인하세요.
포함된 컬렉션
토픽
자주 묻는 질문
- numpydoc은(는) 무엇인가요?
- NumPy 스타일 docstring을 파싱해 구조화된 API 문서로 렌더링하는 Sphinx 확장입니다. numpydoc은 NumPy 문서 형식으로 작성된 docstring을 처리하는 Sphinx 확장입니다. Parameters, Returns, Raises, Examples 같은 섹션을 형식에 맞는 Sphinx 출력으로 변환하므로, Python 프로젝트 전체에서 일관된 docstring 스타일을 유지할 수 있습니다.
- numpydoc은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- numpydoc은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- numpydoc은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. numpydoc의 마지막 커밋은 2026년 11월 1일입니다.
- numpydoc은(는) 어디에 사용할 수 있나요?
- NumPy 스타일 docstring을 사용하는 Python 라이브러리의 API 레퍼런스 문서를 생성합니다. Python API와 함께 np-c 지시문을 사용해 C 확장 함수를 문서화합니다.
- numpydoc은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/numpy/numpydoc
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
코드베이스의 함수, 클래스, 메서드, 모듈 중 docstring이 작성된 항목의 비율을 측정하고, CI에 적합한 통과·실패 기준을 적용하는 Python CLI입니다.
Sphinx보다 가벼운 대안으로, Google 스타일 Python docstring에서 Markdown API 문서를 생성하는 CLI 도구입니다.
reStructuredText 또는 Markdown 소스에서 HTML, PDF, EPUB 등 다양한 형식의 문서를 생성하는 Python 문서 생성기입니다.
Doxygen으로 생성한 C/C++ API 문서를 reStructuredText 및 Sphinx 문서에 통합하는 Sphinx 플러그인입니다.
Sphinx 문서 디렉터리를 감시하고, 변경 사항이 생기면 문서를 다시 빌드한 뒤 로컬 서버를 통해 브라우저를 새로고침하는 CLI 도구입니다.