객체지향 파이썬 프로그래밍 2/e [객체지향 디자인 패턴을 활용한 파이썬 코드 재사용]
- 원서명Mastering Object-Oriented Python: Build powerful applications with reusable code using OOP design patterns and Python 3.7, 2nd Edition (ISBN 9781789531367)
- 지은이스티븐 로트(Steven F. Lott)
- 옮긴이심지현
- ISBN : 9791161757438
- 45,000원 (eBook 36,000원)
- 2023년 05월 31일 펴냄
- 페이퍼백 | 864쪽 | 188*235mm
- 시리즈 : 프로그래밍 언어
책 소개
소스 코드 파일은 여기에서 내려 받으실 수 있습니다.
https://github.com/AcornPublishing/oop-python-2e
요약
파이썬이 제공하는 다양한 객체지향 디자인 패턴을 활용해 강력한 파이썬 프로그램을 개발할 수 있도록 돕는다. 여러 디자인 대안을 소개하고 각 대안의 성능을 비교해보며 현재 해결하려는 문제에 적합한 디자인을 고르는 법을 알려준다. 스페셜 메서드를 통한 파이썬 내장 클래스 활용, 객체 지속성, 객체지향 테스트와 디버깅 같은 고급 파이썬 주제를 풍부하고 일관된 예제로 설명한다.
이 책에서 다루는 내용
◆ __init__() 메소드의 다양한 디자인 패턴
◆ 플라스크로 RESTful 웹 서비스를 만드는 방법
◆ SOLID 디자인 패턴과 원칙
◆ 파이썬 3의 추상 기반 클래스 기능
◆ 사용자 애플리케이션의 클래스 생성
◆ PyTest와 픽스처로 테스트 가능한 코드 디자인
◆ with문을 활용한 컨텍스트 매니저의 디자인
◆ 표준 라이브러리와 디자인 기법을 사용한 새로운 타입의 컬렉션 생성
◆ 새로운 수 타입 개발
이 책의 대상 독자
고급 파이썬을 사용하므로 파이썬 3에 능숙한 독자를 대상으로 한다. 문제 해결을 위해 프로그래밍 언어를 배워야 할 때 유용할 것이다.
이 책은 문법이나 기본적인 개념은 다루지 않는다. 다른 언어에 익숙한 프로그래머라면 파이썬으로 옮길 때 도움이 될 것이다.
파이썬 2 프로그래머가 파이썬 3를 배울 때 특히 유용하다. (버전 2에서 3로 변환하는 도구 등의) 변환 유틸리티나 six 모듈 같은 병립(coexistence) 라이브러리는 다루지 않는다. 이 책은 온전히 파이썬 3로만 할 수 있는 새로운 개발에 집중한다.
이 책의 구성
1장, ‘준비, 도구, 기법’에서는 unittest와 doctest, docstring 같은 미리 알아야 할 주제와 스페셜 메서드명 몇 가지를 다룬다.
2장, ‘__init__() 메서드’에서는 _init_() 메서드를 자세히 설명하고 구현한다. 단순 객체를 초기화하는 여러 형태를 살펴보고, 컬렉션과 컨테이너를 포함하는 보다 복잡한 객체도 알아본다.
3장, ‘매끄러운 통합: 기초 스페셜 메서드’는 간단한 클래스 정의를 확장해 스페셜 메서드를 추가하는 법을 자세히 설명한다.
4장, ‘속성 접근과 프로퍼티, 디스크립터’는 기본 처리가 어떻게 동작하는지 자세히 살펴본다. 언제 어디서 기본 동작을 오버라이드할지 알아내는 법을 배운다. 또한 디스크립터를 비롯해 파이썬의 내부 동작 방식을 알아본다.
5장, ‘일관된 디자인의 추상 기반 클래스’에서는 collections.abc 모듈의 추상 기반 클래스를 알아본다. 수정하거나 확장할 다양한 컨테이너와 컬렉션의 일반적인 개념을 살펴본다. 비슷하게 구현하는 수(number) 개념도 살펴본다.
6장, ‘콜러블과 컨텍스트’에서는 contextlib의 도구를 사용해 컨텍스트 매니저를 생성하는 몇 가지 방법을 알아본다. 콜러블 객체의 여러 디자인 변형도 보인다. 이 과정에서 스테이트풀 콜러블 객체가 왜 단순한 함수보다 더 유용한지 설명한다.
7장, ‘컨테이너와 컬렉션 생성’에서는 컨테이너 클래스의 기초를 설명한다. 컨테이너와 컨테이너가 제공하는 다양한 기능을 생성하는 여러 스페셜 메서드도 다시 살펴본다.
8장, ‘수 생성’에서는 +, -, *, /, //, %, ** 같은 필수 산술 연산자를 다룬다. 또한 <,>, <=,>=, ==, != 같은 비교 연산자도 알아본다.
9장, ‘장식자와 믹스인: 횡단 관심사’에서는 간단한 함수 장식자와 인자를 갖는 함수 장식자, 클래스 장식자, 메서드 장식자를 알아본다.
10장, ‘직렬화와 저장: JSON, YAML, Pickle, CSV, XML’에서는 JSON과 YAML, Pickle, CSV, XML과 같은 다양한 데이터 표현에 특화된 라이브러리를 사용하는 간단한 지속성을 다룬다.
11장, ‘셸브를 통한 객체 저장과 추출’에서는 shelve( 와 dbm) 같은 파이썬 모듈로 수행하는 기초 데이터베이스 연산을 설명한다.
12장, ‘SQLite를 통한 객체 저장과 추출’에서는 SQL과 관계형 데이터베이스라는 보다 복잡한 주제를 다룬다. SQL의 특징과 객체지향 프로그래밍의 특징은 서로 잘 맞지 않아 임피던스 불일치(impedance mismatch) 문제가 발생한다.
13장, ‘객체 전송과 공유’에서는 객체 전송에 쓰이는 HTTP 프로토콜과 JSON, YAML, XML 표현을 알아본다.
14장, ‘설정 파일과 지속성’에서는 설정 파일로 파이썬 애플리케이션을 동작시키는 다양한 방법을 알아본다.
15장, ‘디자인 원칙과 패턴’에서는 SOLID 디자인 원칙을 살펴본다. 몇 가지 모범 사례를 따르면 유지 보수 가능한 고품질의 파이썬 소프트웨어를 구성할 수 있다.
16장, ‘로깅과 경고’에서는 모듈 logging과 warning 모듈을 사용해 감사와 디버그 정보를 생성하는 법을 알아본다. print() 함수보다 한 단계 진화한 방법이다.
17장, ‘테스트 가능한 디자인에서는 테스트 가능한 디자인과 unittest, doctest의 사용법을 다룬다.
18장, ‘명령줄 처리’에서는 argparse 모듈로 옵션과 매개변수를 파싱하는 법을 알아본다. 또한 명령 디자인 패턴을 사용해 쉘 스크립트를 작성하지 않고도 통합시키고 확장시킬 수 있는 프로그램 컴포넌트를 생성해본다.
19장, ‘모듈과 패키지 디자인’에서는 모듈과 패키지 디자인을 다룬다. 모듈 내에 서로 연관된 클래스와 패키지 내에 서로 연관된 모듈을 살펴본다.
20장, ‘품질과 설명서’에서는 소프트웨어가 올바르고 적절하게 구현됐다는 신뢰를 구축하기 위해 디자인을 설명하는 방법을 알아본다.
목차
목차
- 1장. 준비, 도구, 기법
- 기술 요구 사항
- 블랙잭 게임 소개
- 게임 시작
- 블랙잭 플레이어 전략
- 블랙잭 시뮬레이션을 위한 객체 디자인
- 파이썬 런타임과 스페셜 메서드
- 인터랙션, 스크립팅, 도구
- IDE 고르기
- 일관성과 스타일
- 타입 힌트와 mypy 프로그램
- 성능 - timeit 모듈
- 테스트 - unittest와 doctest
- 문서화 - sphinx와 RST 마크업
- 컴포넌트 설치
- 요약
- 2장. __init__() 메서드
- 기술 요구 사항
- 암묵적 최상위 클래스 - object
- 기반 클래스 객체의 __init()__ 메서드
- 최상위 클래스의 __init__() 구현
- 열거형 상수 생성
- 팩토리함수로 __init__() 활용
- 결함이 있는 팩토리 디자인과 모호한 else절
- elif 시퀀스를 이용한 단순화와 일관성
- 매핑과 클래스 객체를 이용한 단순화
- 두 병렬 매핑
- 튜플 값에 매핑
- 부분함수 방식
- 팩토리용 플루언트 API
- 각 하위 클래스에서 __init__() 구현
- 복합 객체
- 컬렉션 클래스 래핑
- 컬렉션 클래스 확장
- 추가적인 요구 사항과 디자인 대안
- 복잡한 복합 객체
- 복합 객체 초기화
- __init()__이 필요 없는 상태가 없는(stateless) 객체
- 추가 클래스 정의
- 다중 전략 __init__()
- 보다 복잡한 초기화
- 정적 혹은 클래스단 메서드 초기화
- 기타 __init__() 기법
- 타입 검사를 포함하는 초기화
- 초기화, 캡슐화, 프라이버시
- 요약
- 3장. 매끄러운 통합: 기초 스페셜 메서드
- 기술 요구 사항
- __repr__()과 __str__() 메서드
- 단순 __str__()과 __repr__()
- 컬렉션 __str__()과 __repr__()
- __format__() 메서드
- 중첩 포맷 명세
- 컬렉션과 포맷 명세 위임
- __hash__() 메서드
- 해시 선택
- 불변 객체 정의 상속
- 불변 객체 정의 오버라이딩
- 가변 객체 정의 오버라이딩
- 가변 핸드로부터 프로즌 핸드 생성
- __bool__() 메서드
- __bytes__() 메서드
- 비교 연산자 메서드
- 비교 디자인
- 같은 클래스의 객체 비교 구현
- 서로 다른 클래스의 객체 비교 구현
- 하드 점수와 소프트 점수 그리고 다형성
- 서로 다른 클래스 비교 예제
- __del__() 메서드
- 참조 계수와 소멸
- 순환 참조와 가비지 컬렉션
- 순환 참조와 weakref 모듈
- __ del__()과 close() 메서드
- __new__() 메서드와 불변 객체
- __new__() 메서드와 메타클래스
- 메타클래스 예제: 클래스단 로거
- 요약
- 4장. 속성 접근과 프로퍼티, 디스크립터
- 기술 요구 사항
- 기본 속성 처리
- 속성과 __init__() 메서드
- 프로퍼티 생성
- 즉시 계산 프로퍼티
- setter와 deleter 프로퍼티
- 스페셜 메서드로 속성 접근
- __slots__으로 속성명 제한
- __getattr__()로 동적 속성 생성
- NamedTuple의 하위 클래스로서 불변 객체 생성
- 즉시 계산되는 속성과 dataclasses, post_init ()
- __setattr__()로 증분 계산
- __getattribute__() 메서드
- 디스크립터 생성
- 비데이터 디스크립터 사용하기
- 데이터 디스크립터 사용하기
- 속성과 프로퍼티에 타입 힌트 사용
- dataclasses 모듈 사용하기
- 속성 디자인 패턴
- 프로퍼티 대 속성
- 디스크립터로 디자인
- 요약
- 5장. 일관된 디자인의 추상 기반 클래스
- 기술 요구 사항
- 추상 기반 클래스
- 기반 클래스와 다형성
- 콜러블
- 컨테이너와 컬렉션
- 수
- 그 밖의 추상화
- 반복자 추상화
- 컨텍스트와 컨텍스트 매니저
- abc와 typing 모듈
- __subclasshook__() 메서드 사용하기
- 타입 힌트를 사용하는 추상 클래스
- 요약, 디자인 고려 사항, 트레이드오프
- 예고
- 예고
- 6장. 콜러블과 컨텍스트
- 기술 요구 사항
- 콜러블 디자인
- 성능 개선
- 메모이제이션이나 캐싱 사용
- functools를 사용한 메모이제이션
- 콜러블 인터페이스로 단순성 추구
- 복잡도와 콜러블 인터페이스
- 컨텍스트 관리와 with문
- 십진 컨텍스트 사용
- 그 밖에 컨텍스트
- __enter__()와 __exit__() 메서드 정의
- 예외 처리
- 팩토리로서의 컨텍스트 매니저
- 컨텍스트 매니저 삭제
- 요약
- 콜러블의 디자인 고려 사항과 트레이드오프
- 컨텍스트 매니저의 디자인 고려 사항과 트레이드오프
- 예고
- 7장. 컨테이너와 컬렉션 생성
- 기술 요구 사항
- 컬렉션의 추상 기반 클래스
- 스페셜 메서드 예제
- 표준 라이브러리 확장 사용
- typing.NamedTuple 클래스
- deque 클래스
- ChainMap 유스 케이스
- OrderedDict 컬렉션
- defaultdict 하위 클래스
- counter 컬렉션
- 새로운 종류의 컬렉션 생성하기
- 컬렉션 타입 좁히기
- 새로운 종류의 시퀀스 정의하기
- 통계 리스트
- 즉시 계산과 지연 계산 선택
- __getitem__(), __setitem__(), __delitem__(), 슬라이스 다루기
- __getitem__(), __setitem__(), __delitem__() 구현
- 리스트 래핑과 위임
- __iter__()로 반복자 생성
- 새로운 종류의 매핑 생성하기
- 새로운 종류의 집합 생성하기
- 디자인 원리
- Tree 클래스 정의
- TreeNode 클래스 정의
- 이진 트리 백 실험
- 디자인 고려 사항과 트레이드오프
- 요약
- 8장. 수 생성
- 기술 요구 사항
- 수의 추상 기반 클래스
- 사용할 타입 결정
- 메서드 결정과 반사 연산자
- 산술 연산자의 스페셜 메서드
- 수 클래스 생성
- FixedPoint 초기화 정의
- FixedPoint 이항 산술 연산자 정의
- FixedPoint 단항 산술 연산자 정의
- FixedPoint 반사 연산자 구현
- FixedPoint 비교 연산자 구현
- 수 해시 계산
- 더 유용한 반올림 디자인
- 다른 스페셜 메서드 구현
- 제자리 연산자로 최적화
- 요약
- 9장. 장식자와 믹스인: 횡단 관심사
- 기술 요구 사항
- 클래스와 그 의미
- 장식자의 타입 힌트와 속성
- 함수의 속성
- 장식된 클래스 구성
- 클래스 디자인 원칙
- 관점 지향 프로그래밍
- 내장 장식자 사용
- 표준 라이브러리 장식자 사용
- 표준 라이브러리 믹스인 클래스 사용
- 믹스인 클래스로 enum 사용
- 간단한 함수 장식자 작성
- 별도 로거 생성
- 장식자 매개변수화
- 메서드함수 장식자 생성
- 클래스 장식자 생성
- 클래스에 메서드 추가
- 장식자를 사용한 보안
- 요약
- 10장. 직렬화와 저장: JSON, YAML, Pickle, CSV, XML
- 기술 요구 사항
- 지속성과 클래스, 상태, 표현 이해하기
- 일반적인 파이썬 용어
- 파일시스템과 네트워크 고려 사항
- 지속성을 지원하는 클래스 정의
- 블로그와 포스트 렌더링
- JSON 덤프와 로드
- JSON 타입 힌트
- 예제 클래스에서 JSON 지원
- JSON 인코딩 커스터마이징
- JSON 디코딩 커스터마이징
- 보안과 eval() 이슈
- 인코딩 함수 리팩터링
- 날짜 문자열 표준화
- JSON을 파일에 쓰기
- YAML 덤프와 로드
- YAML 데이터 파일에 포매팅하기
- YAML 표현 확장
- 보안과 안전한 로드
- pickle 덤프와 로드
- 안정적인 피클 처리를 위한 클래스 디자인
- 보안과 전역 이슈
- CSV로 덤프와 로드
- 간단한 시퀀스를 CSV로 덤프
- CSV로부터 간단한 시퀀스 로드
- 컨테이너와 복잡한 클래스 처리
- CSV 파일에 다양한 행 타입 덤프와 로드
- 반복자로 CSV 행 필터링
- CSV 파일에 조인 행 덤프와 로드
- XML 덤프와 로드
- 문자열 템플릿을 사용한 객체 덤프
- xml.etree.ElementTree로 객체 덤프
- XML 문서 로드
- 요약
- 디자인 고려 사항과 트레이드오프
- 스키마 진화
- 예고
- 11장. 셸브를 통한 객체 저장과 추출
- 기술 요구 사항
- 객체 지속 유스 케이스 분석
- ACID 속성
- 셸브 생성
- 셸브로 표현할 수 있는 객체 디자인
- 타입 힌트를 갖는 객체 디자인
- 객체의 키 디자인
- 객체의 대리 키 생성
- 단순 키로 클래스 디자인
- 컨테이너나 컬렉션의 클래스 디자인
- 외래 키로 객체 참조
- 복잡한 객체의 CRUD 연산 디자인
- 검색, 스캔, 쿼리
- 셸브의 접근 계층 디자인
- 데모 스크립트 작성
- 효율성을 높이는 색인 생성
- 캐시 생성
- 색인 유지 보수 기능 추가
- 라이트백으로 색인 업데이트
- 스키마 진화
- 요약
- 디자인 고려 사항과 트레이드오프
- 애플리케이션 소프트웨어 계층
- 예고
- 12장. SQLite를 통한 객체 저장과 추출
- 기술 요구 사항
- SQL 데이터베이스, 지속성, 객체
- SQL 데이터 모델: 행과 테이블
- SQL DML문을 통한 CRUD 처리
- SQL SELECT문으로 행 쿼리
- SQL 트랜잭션과 ACID 속성
- 데이터베이스의 기본 키와 외래 키 디자인
- SQL로 애플리케이션 데이터 처리
- 순수 SQL로 클래스와 유사한 처리 구현
- 파이썬 객체와 SQLite BLOB 열 매핑
- 파이썬 객체와 데이터베이스 행 수동 매핑
- SQLite 접근 계층 디자인
- 컨테이너 관계 구현
- 색인으로 성능 향상
- ORM 계층 추가
- ORM을 사용한 클래스 디자인
- ORM 계층으로 스키마 생성
- ORM 계층에서 객체 조작
- 태그로 포스트 쿼리
- ORM 계층에 색인 정의
- 스키마 진화
- 요약
- 디자인 고려 사항과 트레이드오프
- 매핑 대안
- 키와 키 디자인
- 애플리케이션 소프트웨어 계층
- 예고
- 13장. 객체 전송과 공유
- 기술 요구 사항
- 클래스, 상태, 표현
- HTTP와 REST로 객체 전송
- REST를 통한 CRUD 연산 구현
- CRUD 이외의 연산 구현
- REST 프로토콜과 ACID
- JSON, XML, YAML 중 표현 선택
- Flask로 RESTful 웹 서비스 생성
- 전송할 문제 도메인 객체
- 간단한 애플리케이션과 서버 생성
- 더욱 정교한 라우팅과 응답
- REST 클라이언트 구현
- RESTful 서비스 데모와 단위 테스트
- 스테이트풀 REST 서비스 다루기
- RESTful 객체 식별자 디자인
- 다중 계층 REST 서비스
- 플라스크 블루프린트 사용하기
- 블루프린트 등록
- 안전한 RESTful 서비스 만들기
- 사용자 비밀번호 해싱
- 웹 애플리케이션 프레임워크로 REST 구현
- 메시지 큐로 객체 전송
- 프로세스 정의
- 큐 생성과 데이터 제공
- 요약
- 디자인 고려 사항과 트레이드오프
- 스키마 진화
- 애플리케이션 소프트웨어 계층
- 예고
- 14장 설정 파일과 지속성
- 기술 요구 사항
- 설정 파일 유스 케이스
- 표현과 지속성, 상태, 사용성
- 애플리케이션 설정 디자인 패턴
- 객체 생성을 통한 설정
- 설정 계층 구조 구현
- INI 파일과 PY 파일에 설정 저장
- eval() 변형으로 더 많은 리터럴 처리
- PY 파일에 설정 저장
- 클래스 정의를 통한 설정
- SimpleNamespace를 통한 설정
- 파이썬 exec()를 사용한 설정
- exec()을 걱정하지 않아도 되는 이유
- 기본값과 오버라이드에 ChainMap 사용
- JSON이나 YAML에 설정 저장
- 중첩이 없는 JSON 설정 사용
- YAML 설정 로딩
- 프로퍼티 파일에 설정 저장
- 프로퍼티 파일 파싱
- 프로퍼티 파일 사용
- PLIST 같은 XML 파일 사용
- 맞춤형 XML 설정 파일
- 요약
- 디자인 고려 사항과 트레이드오프
- 공유 설정 생성
- 스키마 진화
- 예고
- 15장. 디자인 원칙과 패턴
- 기술 요구 사항
- SOLID 디자인 원칙
- 인터페이스 분리 원칙
- 리스코프 치환 원칙
- 개방 폐쇄 원칙
- 의존 관계 역전 원칙
- 단일 책임 원칙
- SOLID 원칙 디자인 테스트
- 상속과 구성으로 기능 생성
- 고급 구성 패턴
- 파이썬과 libstdc++ 간 유사성
- 요약
- 16장. 로깅과 경고 모듈
- 기술 요구 사항
- 기본 로그 생성
- 클래스단 로거 생성
- 로거 설정
- 로깅 시스템 가동과 중지
- 로거 명명
- 로거 레벨 확장
- 다수의 목적지를 지원하는 핸들러 정의
- 전파 규칙 관리
- 설정 주의 사항
- 제어와 디버깅, 감사, 보안을 위한 특수 로깅
- 디버깅 로그 생성
- 감사와 보안 로그 생성
- warnings 모듈 사용
- 경고로 API 변경 알림
- 경고로 설정 문제 알림
- 경고로 가능한 소프트웨어 문제 알림
- 고급 로깅: 최근 메시지와 네트워크 목적지
- 자동 테일 버퍼 생성
- 원격 프로세스에 로깅 메시지 전송
- 큐 오버런 방지
- 요약
- 디자인 고려 사항과 트레이드오프
- 예고
- 17장. 테스트 가능한 디자인
- 기술 요구 사항
- 테스트 단위 정의와 분리
- 의존 관계 최소화
- 간단한 단위 테스트 생성
- 테스트 스위트 생성
- 에지 케이스와 코너 케이스 넣기
- 목 객체로 의존 관계 제거
- 목 객체로 동작 관찰
- doctest로 테스트 케이스 정의
- doctest와 unittest 결합
- 더욱 완전한 테스트 패키지 생성
- 설정과 해제 사용
- OS 자원에 설정과 해제 사용
- 데이터베이스에 설정과 해제 사용
- TestCase 클래스 계층 구조
- 외부에서 정의한 예상 결과 사용
- pytest와 픽스처
- 어서션 검사
- 픽스처로 테스트 설정
- 픽스처로 설정과 해제
- 매개변수화한 픽스처 생성
- 자동 통합 또는 성능 테스트
- 요약
- 디자인 고려 사항과 트레이드오프
- 예고
- 18장. 명령줄 처리
- 기술 요구 사항
- OS 인터페이스와 명령줄
- 인자와 옵션
- pathlib 모듈 사용하기
- argparse로 명령줄 파싱
- 단순 온오프 옵션
- 인자가 있는 옵션
- 위치 인자
- 그 밖에 인자
- —version 표시와 종료
- —help 표시와 종료
- 명령줄 옵션과 환경변수 통합
- 더 설정 가능한 기본값 제공
- 환경변수로 설정 파일 값 오버라이딩
- 설정에 None 값 활용
- 도움말 출력 맞춤화
- 최상위 main() 함수 생성
- 설정의 DRY 원칙
- 중첩 설정 컨텍스트 관리
- 전체적 프로그래밍
- 명령 클래스 디자인
- 분석 명령 하위 클래스 추가
- 애플리케이션에 기능 추가와 패키징
- 좀 더 상위의 복합 명령 디자인
- 또 다른 복합 명령 디자인 패턴
- 다른 애플리케이션과의 통합
- 요약
- 디자인 고려 사항과 트레이드오프
- 예고
- 19장. 모듈과 패키지 디자인
- 기술 요구 사항
- 모듈 디자인
- 모듈 디자인 패턴
- 모듈과 클래스 비교
- 모듈 속 들여다보기
- 전체적 모듈 대 모듈 항목
- 패키지 디자인
- 모듈-패키지 하이브리드 디자인
- 여러 대안 구현을 포함하는 패키지 디자인
- ImportError 예외 사용하기
- 메인 스크립트와 __main__ 모듈 디자인
- 실행 가능한 스크립트 파일 생성
- __main__ 모듈 생성
- 전체적 프로그래밍
- 장기 실행 애플리케이션 디자인
- src와 scripts, tests, docs로 코드 조직
- 파이썬 모듈 설치
- 요약
- 디자인 고려 사항과 트레이드오프
- 예고
- 20장. 품질과 설명서
- 기술 요구 사항
- help() 함수에 쓰일 문서화 문자열 작성
- 파이독을 사용한 설명서
- RST 마크업을 통한 출력 개선
- 텍스트 블록
- RST 인라인 마크업
- RST 디렉티브
- RST 익히기
- 효과적인 문서화 문자열 작성
- 모듈과 패키지를 포함하는 파일단 문서화 문자열 작성
- RST 마크업으로 상세 API 작성
- 클래스와 메서드함수의 문서화 문자열 작성
- 함수 문서화 문자열 작성
- 더욱 정교한 마크업 기법
- 스핑크스를 사용한 설명서 생성
- 스핑크스 퀵스타트 사용
- 스핑크스 설명서 작성
- 설명서를 위한 4+1 뷰 작성
- 구현 문서 작성
- 스핑크스 교차 참조 생성
- 스핑크스 파일을 디렉터리로 리팩터링
- 레거시 문서 다루기
- 설명서 작성
- 문학적 프로그래밍
- 문학적 프로그래밍 유스 케이스
- 문학적 프로그래밍 도구 다루기
- 요약
- 디자인 고려 사항과 트레이드오프