add python OOP

PegasusWang · PegasusWang · commit 8063ddcf05a5 · 2017-01-07T22:14:14.000+08:00
diff --git a/base/basics.rst b/base/basics.rst
@@ -78,7 +78,7 @@ python一大优势在于数量丰富的库，灵活使用各种python库能帮
 专业素养
 ----------
 公司做项目不是自己过家家，需要你具备写文档，注释，单元测试的能力。如果你现在还不了解一个正规python项目都有哪些组建构成，请去github克隆一份知名的代码仓库，花点时间仔细分析下它的项目结构和源代码。
-比如主名网站reddit代码已经开源，大部分python实现，可以参考下。另外很多著名的python库，比如requests/flask等也可以作为参考。
+比如著名网站reddit代码已经开源，大部分python实现，可以参考下。另外很多著名的python库，比如requests/flask等也可以作为参考。
 
 
 后端技术栈
diff --git a/codingstyle/codingstyle.rst b/codingstyle/codingstyle.rst
@@ -132,13 +132,13 @@ update: 经验表明，TDD未必是必要的，但是单元测试是很必要的
 
 还有OOP那一套:
 
+* 单一职责原则(Single-Responsibility Principle)
 * 开闭原则(Open-Closed Principle)
-* 依赖倒置原则(Dependence Inversion Principle)
-* 接口隔离原则(Interface Segregation Principle)
 * 里氏代换原则(Liskov Substitution Principle)
+* 接口隔离原则(Interface Segregation Principle)
+* 依赖倒置原则(Dependence Inversion Principle)
 * 迪米特原则(Law of Demeter)
 * 合成复用原则(Composite/Aggregate Reuse Principle)
-* 单一职责原则(Single-Responsibility Principle)
 
 
 python代码坏味道(新手经常犯的错误)
@@ -151,10 +151,11 @@ python代码坏味道(新手经常犯的错误)
 - 变量名乱起，看不出类型，加重理解负担。我在想是不是动态语言用匈牙利命名法要好一些
 - 不遵守pep8，没有pylint检测，打开代码一堆语法警告，老子的编辑器满眼都是warnning，编辑器用不好就老老实实用pycharm，用编辑器就老老实实装好语法检测和pylint检测插件，没有插件请考虑换一个editor
 - 没有单元测试，不知道怎么写测试（print大法好？）。没有一点专业精神，或许和python大部分都是自学的业余选手有关。
-- 超长函数，没有复用和拆分，我智商低，不能理解好几屏都翻不完的，见谅。这么长居然还tm能工作，牛逼
+- 超长函数，没有复用和拆分，抱歉我智商低，不能理解好几屏都翻不完的，见谅。这么长居然还tm能工作，牛逼(我发现越是新手写的代码越难理解)
 - 到处print，debug的时候加上，上线再删除（累不累亲？），logging模块很受冷落
 - 上来就try/except了，把异常都捕获了，吞掉异常导致排错困难
 - 没注意可变类型和非可变类型，传入可变类型并在函数里修改了参数，坑。。。
+- 滥用 `(*args, **kwargs)` 导致函数接口模糊，有类似接口应该明确用docstring写明参数。
 - 没有逻辑分块，没有美感（这个就算了），就算不限制一行超过80列，也不能写一行写几百列吧，左右转头脑瓜子疼
 
 嗯，一开始就开启pep8和pylint检测能显著提升代码质量（各种错误警告逼着你写出高智力代码）。咱写不了诗一样的代码，也不能写shǐ 一样的代码。
diff --git a/design/design.rst b/design/design.rst
@@ -18,8 +18,11 @@ Patterns》的读书笔记，涵盖大部分设计模式(力求pythonic实现)
 
 先来看三种创建模式中的第一种工厂模式。
 解释：处理对象创建，客户端可以申请一个对象而不用知道对象被哪个class创建。可以方便地解耦对象的使用和创建。有两种实现，工厂方法和抽象工厂.
-### Factory
-Method(工厂方法)：执行单独的函数，通过传参提供需要的对象的信息。通过一个demo看看例子:
+
+Method(工厂方法)：
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+执行单独的函数，通过传参提供需要的对象的信息。通过一个demo看看例子:
 
 ::
 
@@ -57,7 +60,7 @@ Method(工厂方法)：执行单独的函数，通过传参提供需要的对象
         return connector(filepath)
 
 Abstract Factory(抽象工厂: 解决复杂对象创建问题)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 工厂方法适合对象种类较少的情况，如果有多种不同类型对象需要创建，使用抽象工厂模式。以实现一个游戏的例子说明，在一个抽象工厂类里实现多个关联对象的创建：
 
@@ -1422,3 +1425,75 @@ Peters在2002年设计的结合了合并排序和插入排序的\ `Timsort <http
     class MyClass(BaseClass, metaclass=Singleton):
         pass
 
+
+--------------
+
+面向过程与面向对象
+--------------------------------------
+设计模式讲完了，来看看python中OOP的相关东西。笔者在经历过的两家公司见到过各种python程序员，之前的公司有python高手习惯写OOP风格的(给我很深影响)，目前所在公司大部分人对python的面向对象不是很熟，写出来的基本都是过程式的。
+
+- 过程式: 基本都是一个个函数(function)来实现功能，你给我一些参数，我对参数做出各种操作，返回需要的结果。
+- 面向对象：把资源抽象成一个类，数据(data)和方法(method)的集合。在构造函数中进行数据属性的初始化，在方法中进行对象数据的各种操作。
+
+哪种方式更好这个我暂时没有定论，编程规范也不会说强制你使用哪种风格。编码中往往没有绝对正确的，只有相对更优的，如果不好定论，那就一致，易读，易用，易维护的风格优先。
+
+--------------
+
+python中的抽象基类
+--------------------------------------
+在python中我们可以使用内置的abc(abstract base class)模块来实现抽象基类。什么时候需要一个抽象基类呢？
+
+- 抽象基类是没法被实例化的。
+- 抽象基类中定义抽象方法强制子类去实现。
+
+::
+
+    # 为了实现这两个特性，我们可以这么写
+    class Base:
+        def foo(self):
+            raise NotImplementedError()
+
+        def bar(self):
+            raise NotImplementedError()
+
+    class Concrete(Base):
+        def foo(self):
+            return 'foo() called'
+
+        # Oh no, we forgot to override bar()...
+        # def bar(self):
+        #     return "bar() called"
+
+但是这么写依然可以实例化Base，python2.6以后引入了abc模块帮助我们实现这个功能。
+
+::
+
+    from abc import ABCMeta, abstractmethod
+
+    class Base(metaclass=ABCMeta):
+        @abstractmethod
+        def foo(self):
+            pass
+
+        @abstractmethod
+        def bar(self):
+            pass
+
+    class Concrete(Base):
+        def foo(self):
+            pass
+        # We forget to declare bar() again...
+
+使用这种方式如果没有在子类里实现bar方法你是没有办法实例化子类的。
+
+* `《Abstract Base Classes in Python》 <https://dbader.org/blog/abstract-base-classes-in-python>`_
+* `《http://stackoverflow.com/questions/3570796/why-use-abstract-base-classes-in-python》 <http://stackoverflow.com/questions/3570796/why-use-abstract-base-classes-in-python>`_
+* `《https://docs.python.org/2/library/abc.html》 <https://docs.python.org/2/library/abc.html>`_
+
+
+--------------
+
+python中的Mixin
+--------------------------------------
+Mixin是为了给一个类扩充功能用的，它也没法被实例化。我们可以在Mixin类里实现一些方法给类扩充功能。你可能会问了，那为啥不直接写在
+类里头，比如用@staticmethod方法(我就有这个疑问)？我的理解是这样的，为了『高内聚』。如果你用过pylint检测代码，你会发现你在写类的一个方法时，如果在写一个method时没有使用到任何self里的东西，pylint会给提示『R0201 Method could be a function [pylint]』，意思是这个方法可以可以单独写成一个函数，不必要写在类里。也就是说，只有一个类里实现的方法都是使用了self里的数据时才能成为高内聚的（我不知道我这样理解对不对）。例子：flask_login插件有个UserMixin给定义的用户类实现登录功能。
