官术网_书友最值得收藏!

Coding style

The coding style used throughout this book and in the example code conforms to the standards laid out in PEP 8, with one exception. When entering code into an IPython Notebook or providing modules that will be displayed in the notebook, we will not use two lines to separate what would be module-level blocks of code. We will just use one line. This is done to save screen space.

Something that might strike you as different in our code is the use of an extraordinary feature of Python 3—function annotations. The work for this was done in PEP 3107 and was added in the first release of Python 3. The use of types and static analysis in programming, though new to Python, is a boon to the world of software. It saves time in development of a program by catching bugs before they even arise as well as streamlining unit tests. The benefit of this in our particular case, with regard to the examples in this book, is quick, intuitive code clarification. When you look at the functions, you will instantly know what is being passed and returned.

Finally, there is one best practice that we adhere to that is not widely adopted in the Python programming community—functions and methods are kept small in all of our code. If more than one logical thing is happening in a function, we break it into multiple functions and compose as needed. This keeps the code clean and clear, making examples much easier to read. It also makes it much easier to write unit tests without some of the excessive parameterization or awkward, large functions and methods that are often required in unit tests. We hope that this leaves a positive, long-lasting impression on you so that this practice receives wider adoption.

主站蜘蛛池模板: 内黄县| 泰兴市| 东台市| 界首市| 苗栗市| 大英县| 桃源县| 宝清县| 东乡县| 榆树市| 尖扎县| 闵行区| 河池市| 育儿| 莲花县| 秀山| 调兵山市| 宜城市| 互助| 山东省| 嘉善县| 翁源县| 陆川县| 青铜峡市| 宝清县| 苍南县| 清流县| 荔波县| 涿州市| 白河县| 广宗县| 新蔡县| 永吉县| 同江市| 永新县| 西畴县| 五寨县| 呼和浩特市| 嫩江县| 通许县| 思南县|