Designing Pythonic library APIs

原文英文，约6500词，阅读约需24分钟。发表于：。

Principles I've found useful for designing good Python library APIs, including structure, naming, error handling, and type annotations.

本文介绍Python库API设计的原则，包括遵循PEP 8和PEP 20规范，简单易用的API设计，简洁明了的命名，使用下划线表示私有变量，异常以及版本更新的处理，使用关键字参数和动态类型保持向后兼容。同时，文章也提到了Python的类型注释和数据类的使用，以及Python的灵活性需要谨慎使用。