- 博客(3)
- 收藏
- 关注
原创 飘逸的python - 代码即文档docstring
什么是docstring在软件工程中,其实编码所占的部分是非常小的,大多是其它的事情,比如写文档。文档是沟通的工具。 在python中,比较推崇在代码中写文档,代码即文档,比较方便,容易维护,直观,一致。 代码写完,文档也出来了。其实Markdown也差不多这种思想,文本写完,排版也完成了。 看看PEP 0257中对docstring的定义: A docstring is a string
2015-07-10 14:05:31 28377
原创 使用sphinx生成美观的文档
先上效果图详情首先,需要知道什么是restructuredtext,可以理解为类似于markdown的一个东西。然后安装,pip install sphinx进入存放文档的目录,在命令行,sphinx-quickstart ,根据需要一路回车,会生成一堆东西,包括conf.py和make等根据需要修改conf.py编写rst文件,比如默认的index.r
2015-07-06 21:00:32 10947 1
原创 独立python环境之virtualenv和virtualenvwrapper
介绍假设有一台测试机,多个人使用,有多个项目,不同项目可能python版本不一样,需要的库不一样。我们需要一个独立干净的python环境,互相隔离,互不影响。 virtualenv可以帮我们解决这个问题。 virtualenvwrapper是virtualenv的封装,可以方便的创建/删除/拷贝/切换不同的环境。安装与配置 pip install virtualenv pip ins
2015-07-06 13:46:49 4159
空空如也
空空如也
TA创建的收藏夹 TA关注的收藏夹
TA关注的人