2024年Python最新Python 函数库 APIs 编写指南_python中apis(3)，字节面试官

一个月成就技术

于 2024-05-04 01:49:05 发布

阅读量828

点赞数 20

分类专栏：程序员文章标签： python 开发语言

本文链接：https://blog.csdn.net/m0_54816834/article/details/138430154

版权

程序员专栏收录该内容

145 篇文章 2 订阅

订阅专栏

最后

🍅 硬核资料：关注即可领取PPT模板、简历模板、行业经典书籍PDF。
🍅 技术互助：技术群大佬指点迷津，你的问题可能不是问题，求资源在群里喊一声。
🍅 面试题库：由技术群里的小伙伴们共同投稿，热乎的大厂面试真题，持续更新中。
🍅 知识体系：含编程语言、算法、大数据生态圈组件（Mysql、Hive、Spark、Flink）、数据仓库、Python、前端等等。

网上学习资料一大堆，但如果学到的知识不成体系，遇到问题时只是浅尝辄止，不再深入研究，那么很难做到真正的技术提升。

需要这份系统化学习资料的朋友，可以戳这里获取

一个人可以走的很快，但一群人才能走的更远！不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

命名问题：你 API 中的命名是否和 Python 的习俗保持了一致性？我们命名应该与 PEP8 中所给出一致。PEP8 是 Python 官方的代码风格指南。为了保持命名与代码风格的一致性，建议使用 flake8 来规范你的 API 代码。

命名问题：API 中的命名是否一致？

术语的顺序：string_encodeVSdecode_string
缩写问题：activate_prevVSfetch_previous以及bin2hex VSstrtolower
是否带有下划线：gettypeVSget_class
单复数问题：values_list VSvalue_list
正负问题：button.enabled == TrueVSbutton.disabled == True

空值问题：在空值意义的定义是否一致？目前的是最好的选择吗？

决定下面哪个代表了空值：None、False、[]、‘’、0
小心一些出人意料的值：bool(datetime.time(0)) == False在Python3.5以前是这样

参数问题：在参数的顺序上是否具有一致性？例如：datetime.datetime(year, month, day, minute, second, microsecond)vsdatetime.timedelta(days, seconds, microseconds, milliseconds, minutes, hours, weeks)

行为问题：在相似或者不同的行为上是否具有一致性？行为的不对称应该反应在格式的不对称上。例如，numbers.sort() VSsort(numbers)

灵活性

减小整体的不连续性

检查所有的类的功能是否单一职责？如果不是，就应该把那些类拆解开来。例如，一个从缓存中获取数据的类应该将其连接缓存服务器的步骤交给另一个类做。
检查函数的名称中是否包含了and 或者是否包含多个操作。如果确实如此，应该将这个函数拆成多个不同的函数。但是，如果这个函数经常被调用，那么可以保留一个结合了众多函数的函数。例如：print_formatted 函数可以被拆解为两个函数：print和formated
检查是否存在用户复制粘贴代码以改变函数功能的行为。应该提供代码重构，回调功能。
检查在函数内部是否使用了属性值，如果有可以使用 get_something 方法代替。例如在 Djando 的 REST 框架中， CursorPagination 这个类仅仅支持一个固定大小的属性值：page_size，其原因就是这个类没有get_page_size 这个方法。这个问题再后来就通过上述方法解决了，即添加了 get_page_size 方法。
尽量避免隐藏可能有用的参数。例如我们的 API 中调用了另一个低级的 API 但是却没有展示这个低级 API 的参数情况
返回用户可能需要的一切信息
用户调用 API 时，要处理用户可能需要所有情况
在进行 API 测试的时候要测试每一个mock.pathch。虽然在程序运行的时候有一些东西不容易修改，但我们可以通过设置参数来修改某些东西。例如，Python 的内置函数 sched.scheduler接受两个参数timefunc 和delayfunc。而我们没必要对 time.monotonic和time.sleep 两个函数进行 mock 测试，用户会根据自己的需求进行相应的改变。

建立抽象

按照底层实现的结构，去封装我们的函数成员与对象。例如 Beautiful Soup 就为多个分析器设计了同样的 API 结构。
提供多级的抽象结构，从最简单到最个性化。例如， Celery 既提供了 @app.task这个装饰器，又提供了个性化的 task 类，而这个类继承于celery.Task
提供摆脱封装的方法，让用户可以直接使用被抽象的资源和能力。例如，Django 的查询集合支持使用 .extra 方法将自定义的 SQL 与 ORM 进行结合来产生查询语句，同时也支持使用.raw 来直接使用原生的 SQL 查询语句。
将底层实现中常见的错误进行封装，避免给用户直接报错。例如当 API 支持多个数据引擎的时候，出现数据库连接错误时，其显示信息应该一样。这个帮助用户找出问题所在，并且在修改数据库引擎时不会需要修改很多代码。

要有 Python 范

对于获取（get）和设置（set）操作使用 Python 的自带属性
对于运算符重载要使用魔法方法（magic method）
对于简单的调试，使用__repr__魔法方法
对于包含打开-关闭或者开始-结束这样的包含生命周期的问题，使用 with 语句
对于容易组合共同行为或者登记某些东西使用装饰器
对于迭代使用迭代器
对于复杂的逻辑问题使用生成器
对异步问题使用 asyncio
尽量使用内置的集合
对于简单的控制反演使用简单的高级函数，例如在list.sort函数中接受key 参数作为等级高低计算函数以便计算列表的顺序。
对于复杂的流程问题，可以按照函数/类的管道、继承、生成器的顺序逐一考虑。例如管道问题可参考：python-social-auth 管道；继承问题可参考：Django 的类；生成器问题可参考：Scrapy 的爬虫程序。
尊重鸭子式编程风格，要求谅解比谅解本身更加容易