beta

阅读:十二月 6 日

Understanding Python’s “yield” Keyword

(来自 Pycoders Weekly Issue #295

http://stackabuse.com/understanding-pythons-yield-keyword/

一篇关于 Python 的 yield 关键字(以及 generator)很好的入门文章。


Django 2.0 released

(来自 Pycoders Weekly Issue #295

https://www.djangoproject.com/weblog/2017/dec/02/django-20-released/

Django 发布 2.0 版本了。新特性有:

还有一些向下不兼容的改动:


User experience design for APIs

(来自 碼天狗週刊 Issue 108

https://blog.keras.io/user-experience-design-for-apis.html

在设计和开发面向用户的软件时通常要考虑 user experience(UX),而隐藏在软件用户界面背后的 API 也需要为其用户(开发者)优化使用体验。作者介绍了他在设计 API 时的三条规则:

  1. 设计整体的 workflow,而不是 atomic methods(使 workflow 贴合领域需求、为新用户提供入门指南)。
  2. 减轻用户理解 API 的认知负担(命名一致、减少概念、带例子的文档)。
  3. 为用户提供有帮助的反馈(FAQ、详细的错误信息、建立提问社区)。

对于第 2 条,我最近在工作中感受比较深。公司用 Java 做了一个测试平台,在编写测试用例时必须掌握的概念有 test group、test case 和 test suite,不同的 test suite 又有不同的专用名称,再辅以我司一贯的滥用缩写的风格,痛不欲生。