牛大了，这代码看着真专业

是 否 +2 论坛币

k人 参与回答

经管之家送您一份

应届毕业生专属福利!

求职就业群

赵安豆老师微信：zhaoandou666

经管之家联合CDA

送您一个全额奖学金名额~ !

立即领取

感谢您参与论坛问题回答

经管之家送您两个论坛币！

+2 论坛币

作者：麦叔

来源：麦叔编程

引子

今年开始，我在翻译一本大部头的，比较经典的的Python进阶书籍。

有空就翻译几页。这本书不仅是教你很多进阶的Python的语法，更重要的是讲解很多设计方法和设计思想。

这些方法和思想，一点点叠加起来，就会让你从一个普通的程序员变成一个很专业的程序员。至少看起来挺唬人的！

昨天我在翻译关于docstring的章节。书中举的一个例子，把一个很普通的类，转变成了跟Python内置的库一样专业的代码。

我感觉眼睛一亮，觉得有必要跟大家分享一下。

设计需求

这个类的功能很简单：

• 类名Point，代表二维坐标系中的一个点。
• 属性：x和y代表二维坐标
• 方法：类包含3个方法，实现了“回到原点”，“移动到指点的点”，“计算两个点之间的距离”。
  

想想看，你会怎么写呢？

专业级的代码

我就直接分享我认为比较专业的代码吧，请仔细阅读，品味其中专业的地方：

1. class Point: """
   
2.     Represents a point in two-dimensional geometric coordinates
   
3.     >>> p_0 = Point()
   
4.     >>> p_1 = Point(3, 4)
   
5.     >>> p_0.calculate_distance(p_1)
   
6.     5.0
   
7.     """ def __init__(self, x: float = 0, y: float = 0) -> None: """
   
8.         Initialize the position of a new point. The x and y
   
9.         coordinates can be specified. If they are not, the
   
10.         point defaults to the origin.
    
11.         :param x: float x-coordinate
    
12.         :param y: float x-coordinate
    
13.         """ self.move(x, y) def move(self, x: float, y: float) -> None: """
    
14.         Move the point to a new location in 2D space.
    
15.         :param x: float x-coordinate
    
16.         :param y: float x-coordinate
    
17.         """ self.x = x
    
18.         self.y = y def reset(self) -> None: """
    
19.         Reset the point back to the geometric origin: 0, 0
    
20.         """ self.move(0, 0) def calculate_distance(self, other: "Point") -> float: """
    
21.         Calculate the Euclidean distance from this point
    
22.         to a second point passed as a parameter.
    
23.         :param other: Point instance
    
24.         :return: float distance
    
25.         """ return math.hypot(self.x - other.x, self.y - other.y)

复制代码

来说一下，为什么我觉得这段代码是专业级的：

• 类名和方法名都非常直观，简单易懂。有没有？
• 通过docstring，类和方法都加了非常简明扼要的文档。看起来就很像内置库的代码。
• 函数都使用类型提示，增加代码可读性，可以使用mypy等做类型检查。
• __init__函数使用了默认值，确保每个初始化出的实例都有有效的属性值。
• reset函数没有自己实现轮子，而是直接调用move方法。
• 类的docstring中提供了使用例子，可以用doctest等测试工具做代码的简单自动化测试。
  

相关帖子DA内容精选 2022年300个以上最佳免费数据科学课 大厂数据分析面试指南！来自亚马逊、谷歌、微软、头条、美团的面试问题！ 机器学习模型方法总结 历史最全机器学习/深度学习/人工智能专业术语表中英对照表 机器学习如何应用于商业场景？三个真实的商业项目 数据工作者的自我修养 | 哪些技能是必不可少的？ 《汗牛充栋：数据分析书籍分享》CDA网校新课上线 文本挖掘常用的107个语料库 一图读懂“东数西算”工程 零基础转行数据分析，看这篇文章就够了

扫码加我 拉你入群

请注明：姓名-公司-职位

以便审核进群资格，未注明则拒绝

分享0 收藏0 回帖

关键词：Coordinates Dimensional coordinate represents calculate