Design Notes

Behind-the-scenes stories about design challenges encountered while building PyQuantLib.

Each note covers a specific problem: the symptoms, the investigation, the failed attempts, and the solution. They document why certain patterns exist in the codebase and offer other binding authors lessons from similar challenges.

For a high-level overview of the tensions that shaped PyQuantLib’s architecture, see Architecture.

• API Design
• The Interpolation Binding Saga
• The Settings Singleton Mystery
• The Hidden Handle Pattern
• The Bridge Pattern Trap
• The Python Subclassing Challenge
• The Protected Member Problem
• The Enum Singleton Problem
• The Cross-Translation-Unit Holder Problem
• The Diamond Inheritance Problem
• The Builder Pattern
• The Reference Member Trap