status

校对

完成度~85%;

TableOfContents

行者箴言

光说不练徦把式，光练不说傻把式！ ~ 所以,汇集散落在书中各处的行者"箴言"细说来由;-)

每节使用固定的述说模式:
1. 给出E文定义
2. 给出实例故事的出处
3. 讲述产生的背景
4. 展开解说相关的体验,给出进一步的阅读资料

用之,不学!

Enjoy it! don't Learnning

来自 [:ObpLovelyPython/CDay-5:CDay -5 Python初体验和原始需求]

背景

"[编程杂谈]做个项目吧"
- 访问地址: http://blog.donews.com/limodou/archive/2004/12/10/199174.aspx
- 精巧地址: http://bit.ly/YOdMc
来自中国Python 著名行者 Limodou 的Blog,是他维护着 UliPad(当时还叫 NewEdit) 这一轻便实用纯Python 实现的编辑器项目
- UliPad工程网站: http://code.google.com/p/ulipad/
在文中 Limodou 倡导在项目开发的实际应用中学习相关知识

解说

这是本书的核心本愿!
在 CPyUG ~ China Python User Group(中国Python)用户组的邮件列表长期维护过程中笔者们发现:
- "怎么可以学好Python ?" 是初学者最经常和反复提到的一个问题!
这个问题,怎么回答,其实不是简单的学习经验的分享,而是怎么传达 Pythonic 精神和自信的哲学性问题;
通过 Limodou 的倡议,大家最终确认了这一学习原则:用之,不学!
为学习Python 而学习,是最不可取和南辕北辙的;因为, Python 本来就是为了快速解决常见问题而创造出来的,不是为了印证什么编程理论或是模式;所以, "在战斗中学习战斗",是Python 学习的最合适态度,而且也只有在面对实际问题时,才可以真正感受到Python 的简便/友好/直觉!如果拉开架式,为了写出漂亮的面向对象的或是吻合什么模式的代码而去研究Python,那就失去了用Python快捷解决问题的爽快体验了!

{{{脚注:: CPyUG的主力邮件列表地址是: http://groups-beta.google.com/group/python-cn 精巧地址: http://bit.ly/3895ZW 啄木鸟自由软件社区,则是另外一个中国Pythoner 聚集地; 和CPyUG 的关系可以参考: http://wiki.woodpecker.org.cn/moin/WoodpeckerAbt 精巧地址: http://bit.ly/4DHYa0 }}}

寻之!不造.

Searching at first,Don't try creat!

寻找吧!不要先想着创造--Python 是自足的
- 来自 [:ObpLovelyPython/CDay-4:CDay -4 可用的首个Python脚本]
你能够碰到的问题,99%的情况下其它人已经遇到过了,所以,最佳的解决方式就是找到那段别人解决相似问题的代码!
- 来自 [:ObpLovelyPython/CDay-1:CDay -1 中文处理完成功能的实用化]

背景

图 atta1-1 漫画电池内置
attachment:atta1-1.jpg
Batteries Included~电池内置 是Python 的哲学之一!
- 详细说明: http://www.uselesspython.com/BatteriesIncluded.html
- 精巧地址: http://bit.ly/2vPE15
意思是python语言本身,已经天然内置了足够多的实用模块,可以完成大多数常见任务的!
成功故事之一:
- EZTrip.com 选择Python 进行企业整合的故事: http://www.python.org/about/success/eztrip/
- 精巧地址: http://bit.ly/4TrC2
另外相关Blog一篇: "[编程杂谈]开始读源码吧"
- 访问地址: http://blog.donews.com/limodou/archive/2005/04/26/352565.aspx
- 精巧地址: http://bit.ly/nS0rE
- 同样来自 Limodou 的体验分享,文中指出,想写出好代码,就要多看其它优秀作品的源代码;这不仅仅要提取出对自个儿用有的代码,同时也是学习他人的思路和工程设计/组织经验;

解说

有自由/开源软件的世界里,解决问题的最快捷途径绝对不是自个儿堆代码解决!
嗯嗯嗯,当然的出于"程序员"的自尊,以及关键性的经济条件,一般也不允许去买软件来解决问题;-)
Python 使用开源许可证:
- 全文访问: http://www.python.org/download/releases/2.4.2/license/
- 精巧地址: http://bit.ly/1xTbla
所以,各种基于Python 的项目一般都乐于公开源代码;
加之,Python 因为有丰富的C语言接口,实际上也是种方便的胶水语言--可以平滑的直接或是通过接口模块和各种开发语言協同完成任务!
故而,用Python 来解决问题,基本上不用自个儿冥思苦想整出代码来,只要用心先搜索一下根据问题域的解决方案设想,广泛调研一下,基本都可以找到一个以上的支持模块或是软件--当然是Python 写的,下载来,稍微配置或是定制/修改一下就好! 作为Pythoner ,应该有这种自觉和自信!
不过,Python 的各种支持模块/软件都是各行其是的分散在网络中,并没有象Perl 的CPAN 那样形成统一聚集地;
当前,比较集中的 Python 作品索引中心有:
- Python Package Index
  - 访问地址: http://pypi.python.org/pypi
  - 精巧地址: http://bit.ly/2QQiMz
  - Python 官方网络组织的模块包索引,和 setuotools 工具协同,可以自动下载和升级各种己注册模块;
- The Vaults of Parnassus: Python Resources
  - 访问地址: http://py.vaults.ca/apyllo.py
  - 精巧地址: http://bit.ly/10KY2U
  - 以问题域为分类,长期收集有大量的软件包信息
- Python Starship
  - 访问地址: http://starship.python.net/crew/index.html
  - 精巧地址: http://bit.ly/eMW11

CPAN

attachment:cpan.jpg
访问地址: http://www.cpan.org/
即: Comprehensive Perl Archive Network ~ Perl 综合典藏网
它是一个巨大的Perl软件收藏库，收集了大量有用的Perl模块(modules)及其相关的文件。由于CPAN的收藏丰富，使用者甚多，在世界各地都有许多CPAN的镜站(mirror site)存在。

CPAN亦是一支Perl程式的名字，其作用是让使用者容易从CPAN下载、安装、更新及管理其他在CPAN上的Perl程式,日常使用类似:

~$ perl -MCPAN -e shell
#第一次进入CPAN时，CPAN将会进行一次配置(configuration)。当配置完成后，就可以利用CPAN来查询CPAN内的Perl模块，并且进行安装。一般操作如下：

CPAN> d /bioperl/

查询有关bioperl的模块

CPAN> install modulename

安装指定的模块

CPAN的成功引来很多其他编程语言社群的模仿。CTAN（Comprehensive TeX Archive Network，TeX综合典藏网）和CSAN（Comprehensive Scheme Archive Network，Scheme综合典藏网）都参考了CPAN的命名方式。另外PEAR（PHP Extension and Application Repository）也是类似CPAN的PHP程式网站!
8卦一下: 在Perl 6 之后,因全新设计的Parrot引擎,支持其它语言的解析和字节码编译,故而,Python 有望直接使用CPN!

否之!守之!

Keep evolution,never foget the start idea!

不断的否定自己,但是要坚持最初的妄想^{--不论战术上如何变化,千万不要忘记战略目标}
- 来自 [:ObpLovelyPython/CDay-3:CDay -3 通过函式进行功能化]

背景

"[编程杂谈]编程就象练书法"
访问地址: http://blog.donews.com/limodou/archive/2006/04/02/808281.aspx
精巧地址: http://bit.ly/3TGsCt
还是来自 Limodou 的体验分享,文中指出:编程应该象练毛笔字--只求耕耘,不求收获;在不断的反复修订中积累经验和思路,才会有那么一天一切豁然开朗的!

解说

这是 Pythonic 重构心态的劝戒;
在[:ObpLovelyPython/PCS404:PCS404 代码重构浅说] 中有相关的简介；
这里特别指出的: 很多时候最初那一瞬间的设想/构思/概念可能就是整个软件/项目/工程的最核心亮点,千万不要在代码展开编写后,逐渐被各种意外问题所迷惑,忘记了最初那个自个儿真正想完成的功能!
不断的否定自己,意思是否定自个儿现在的代码实现方式,而不是功能,并且,在重构/增补代码/功能时,有一个基础指标要守住 -- 确保现有所有功能是运行正常的,是可用的,通过测试的!

发布,持续!

Keep realese,Keep publish!

发布!为了全人类!因为一个人如果力求完善自己，他就会看到，为此也必须同时完善他人。一个人如果不关心别人的完善，自己便不可能完善。
发布好象不是通告一嗓子就好的事儿 ~ 分分分!学生的命根! 文档,文档,文档!软件的颜面!
- 来自 [:ObpLovelyPython/CDay0:CDay 0 感受软件工程进行发布的准备]

背景

一个人如果力求完善自己，他就会看到，为此也必须同时完善他人。一个人如果不关心别人的完善，自己便不可能完善。 源自庄秀丽老师(任教于北京师范大学教育技术学院)曾经的一篇Blog:

读书摘要——拔高一个层次看分享与协作

一个人如果力求完善自己，他就会看到，为此也必须同时完善他人。
一个人如果不关心别人的完善，自己便不可能完善。

这是因为，人要充分发展自己的天性，必须充分发展他的人际关系，也就是在社会之中。

这就回到了孔子、孟子的传统，人要想完善自己，必须实行忠恕、仁义，这就包含了帮助别人。
人要想完善自己，就必须充分发展上苍的天性，帮助别人就是参与天地化育万物的工作。
一个人如果真正懂得了这一切，他就与天地合参，成为一体了。

《中庸》所讲的“明”，便是这个意思：人做到与天地合参，便是完美。

在《中庸》里，至善被称为“诚”（真诚、纯真）和“明”是连在一起的。
《中庸》第二十一章说：“
自诚明，谓之性。
自明诚，谓之教。
诚则明矣，明则诚矣。”一个人如果把他所领会的都付诸实践，他也就是圣人了。

人只有在自己的实践中，才能懂得这些普通、寻常事的真正意义；也只有真正懂得它们的意义，才能做得完美。

从中可以体验到分享是暗含帮助他人从而令自己完善的致理的！

另外一篇Blog:"[编程杂谈]写写Blog吧"
访问地址: http://blog.donews.com/limodou/archive/2004/12/14/202590.aspx
精巧地址: http://bit.ly/49NSOE
依然来自 Limodou 的分享文章,文中指出:"分享你的心得吧",从中不仅仅可以通过文字的形成,将自个儿的想法和设计真正厘清,同时也是获得越来越多同道中人关注和相互激发的好途径!

解说

在 WEB2.0 时代,各SNS网站都开始号称永远的beta 版本,也就是持续发布和改进;
豆瓣网就是其中的实例,在不断的和用户交互沟通过程中,不断的增/删/改网站功能,令网站服务在使用中,不断的及时的影响用户的需求,成为好用的,人们喜欢用的系统;
再小的程序开发也应该一样,软件开发的本质目标是解决问题,而程序员写程序,就应该永远想着自个儿的代码可以长久的应用下去,可以在所有相似的情景中快速得到复用!
这就要求对代码要在运行过程中不断的根据新要求/新目标/新情况,持续修订/重构,令代码逐渐变的凝练,稳固!同时,代码本身也应该是简单明晰的,借助简略恰当的注释,甚至于不用注释,任何人都可以快速理解代码的设计思路,执行淤积,实现结构,可以立即加入到其它应用中,稳定的支撑起新的软件来!
所以,发布一直以来就应该是对内对外的双重发布:
1. 对内: 为自己,通过发布和整理,以及注释更新,令开发者自身,加深对代码的理解,并及时进行再次重构迭代;
2. 对外: 为公众,通过发布和宣传,让其它人获知软件的状态,令有缘人可以及时得到我们的代码,并通过清晰易懂的代码建立起沟通渠道,可以就相似问题域的解决进行互通有无,令好代码传播出去,延长生命周期的同时,也因为及时丰富的使用反馈,令自个儿的代码可以进一步得到增补!

先用,再修,

Run! before Enhancement

没有完美的软件!够用并且容易使用的软件已经算是完美的了
- 来自 [:ObpLovelyPython/CDay-2:CDay -2 利用文本文件完成核心功能]
没有最好,只有更合理!
- 来自 [:ObpLovelyPython/CDay1:CDay +1 首次重构优化数据结构]

背景

"东拉西扯：谁需要更复杂的软件 - 对牛乱弹琴"
访问地址: http://blog.donews.com/keso/archive/2005/11/18/630753.aspx
精巧地址: http://bit.ly/4d8BSN
来自著名博客 keso(洪波),文中从办公软件的对比说开去,就软件本身的品质/功能/易用性等等方面提出了尖锐的诘问;
从中笔者提纯出的概念是:"当软件或是系统再也没有任何可以放弃的功能时,软件或是系统才处于最佳状态!"
软件或是系统,并不是越大越复杂就越好的! 因为组成软件的代码,当多到一定程度时,其维护代价会突变,变成完全陌生的怪兽般无法控制! 所以,很早,在软件的远古时代先贤们就提出了好软件的艺术规范:
1. 让每个程序就做好一件事;
2. 假定每个程序的输出都会成为另一个程序的输入,哪怕那个程序还是未知的;
3. 尽可能早地将设计和编译的软件投入试用,对拙劣的代码别犹豫,扔掉重写;
GNU体系中灿若繁星的优秀软件,就是充分运用以上原则创造出来的;进一步的推荐图书: 图 atta1-2 Unix编程艺术 attachment:unix-art.jpg
- 豆瓣推荐: http://www.douban.com/subject/1467587/
- 精巧地址: http://bit.ly/1xsinL

解说

以上持续修改的思想,被行者们精炼成了: Python 八荣八耻
访问地址: http://wiki.woodpecker.org.cn/moin/Py8Rong8Chi
精巧地址: http://bit.ly/4e7L5C

以动手实践为荣 , 以只看不练为耻;
以打印日志为荣 , 以单步跟踪为耻;
以空格缩进为荣 , 以制表缩进为耻;
以单元测试为荣 , 以人工测试为耻;

以模块复用为荣 , 以复制粘贴为耻;
以多态应用为荣 , 以分支判断为耻;
以Pythonic为荣, 以冗余拖沓为耻;
以总结分享为荣 , 以跪求其解为耻;

这其中有很多Python的方言性经验,如果没有使用过Python 的读者,可能无从想象,笔者特此对其中一个要点进行简述,其它的就得读者自行在实践中印证进而和鸣了:-)
- 以空格缩进为荣 , 以制表缩进为耻; ~ 这是因为Python 是世界上唯一成功的将代码排版和语法结构融合的语言!例如:
```
   1 def formatCDinfo(root,dirs,files):
   2     export = "\n"+root+"\n"
   3     for d in dirs:
   4         export+= "-d "+root+_smartcode(d)+"\n"
   5     for f in files:
   6         export+= "-f %s %s \n" % (root,_smartcode(f))
   7     export+= "="*70
   8     return export
```
  其中的函式声明,for 循环体等语法结构的划分,就是使用 :配合缩进完成的,这比其它主流语言使用{以及}来标识,要科学和人性的多!因为这样一来:
  - 任何人写的Python 脚本有统一的排版,方便他人理解程序思路;
  - 禁止了任何人写出极其丑恶的非人性代码来!比如说:
```
#include <stdio.h>
main(t,_,a)char *a;{return!0<t?t<3?main(-79,-13,a+main(-87,1-_,
main(-86,0,a+1)+a)):1,t<_?main(t+1,_,a):3,main(-94,-27+t,a)&&t==2?_<13?
main(2,_+1,"%s %d %d\n"):9:16:t<0?t<-72?main(_,t,
"@n'+,#'/*{}w+/w#cdnr/+,{}r/*de}+,/*{*+,/w{%+,/w#q#n+,/#{l+,/n{n+,/+#n+,/#\
;#q#n+,/+k#;*+,/'r :'d*'3,}{w+K w'K:'+}e#';dq#'l \
q#'+d'K#!/+k#;q#'r}eKK#}w'r}eKK{nl]'/#;#q#n'){)#}w'){){nl]'/+#n';d}rw' i;# \
){nl]!/n{n#'; r{#w'r nc{nl]'/#{l,+'K {rw' iK{;[{nl]'/w#q#n'wk nw' \
iwk{KK{nl]!/w{%'l##w#' i; :{nl]'/*{q#'ld;r'}{nlwb!/*de}'c \
;;{nl'-{}rw]'/+,}##'*}#nc,',#nw]'/+kd'+e}+;#'rdq#w! nr'/ ') }+}{rl#'{n' ')# \
}'+}##(!!/")
:t<-50?_==*a?putchar(31[a]):main(-65,_,a+1):main((*a=='/')+t,_,a+1)
  :0<t?main(2,2,"%s"):*a=='/'||main(0,main(-61,*a,
"!ek;dc i@bK'(q)-[w]*%n+r3#l,{}:\nuwloca-O;m .vpbks,fxntdCeghiry"),a+1);}
```
    注意,这是正确可运行的C代码哪, 而且世界上有专门的网站(http://www.ioccc.org),每年评选出最令人尖叫的正确代码!
  - 但是,Python 这一精心设计,在使用中,有不小的阻力,因为大家心爱的编辑环境各不相同,养成的缩进习惯也不一样,经常造成别人的代码,到自个儿这儿打开一看缩进非常的大(因为TAB~制表符在不同的编辑器中自动处理后表现出来的空格数目是不同的)!又或是将另外的代码复制过来就出错~因为TAB和空格混用时,Python 就无法正确的判定出语法结构了!
  - 所以,行者们建议,使用四个空格来代替所有的TAB(当然的好的编辑器是可以配置成TAB是自动替换成4个空格的!)

网站?软件!

Site is Software!

网站软件化绝对不是空话! 来自 [:ObpLovelyPython/CDay2:CDay +2 用户界面友好化]

背景

SaaS(Software as a Service,软件作为服务，或称为软件即服务)是应用软件的一种销售方式，客户按使用时间或使用量付费。这些应用软件通常是在企业管理软件领域，并通过互联网来使用。
它是目前一种新型软件服务形式，是从 ASP(ApplicationServiceProvider，应用服务提供商)模式演变而来，是一种通过Internet提供软件的模式。用户不用再购买软件，而改用向提供商租用基于Web的软件，来管理企业经营活动，且无需对软件进行维护，服务提供商会全权管理和维护软件。
对企业来说，SaaS的优点在于：
从技术方面来看：企业无需再配备IT方面的专业技术人员，同时又能得到最新的技术应用，满足企业对信息管理的需求。
从投资方面来看：企业只以相对低廉的“月费”方式投资，不用一次性投资到位，不占用过多的营运资金，从而缓解企业资金不足的压力；不用考虑成本折旧问题，并能及时获得最新硬件平台及最佳解决方案。
从维护和管理方面来看：由于企业采取租用的方式来进行物流业务管理，不需要专门的维护和管理人员，也不需要为维护和管理人员支付额外费用。很大程度上缓解企业在人力、财力上的压力，使其能够集中资金对核心业务进行有效的运营。

解说

GUI~图形用户界面 (Graphic User Interface)的简称;也指代所有工作在各种图形化操作系统中,通过各种图形化窗口控件和用户交互的软件; 这类软件必然的依赖操作系统提供的图形控制接口,以便实时绘制,采集用户反馈等等;
当然的Python 也可以开发这类软件的,而且可以使用的图形接口和框架也不少,这方面推荐前面"Eurasia ~ 关注高性能的原创框架" 一节的作者沈崴的文章:Python 史书·GUI 部
- 在线阅读: http://wiki.woodpecker.org.cn/moin/PyHiStory/PyGuiHistoric
- 精巧地址: http://bit.ly/3R8nHK
不过,现在的趋势是:"网站软件化",从Google桌面搜索(http://desktop.google.com)开始利用本地网页当搜索引擎的交互和控制界面,到Yahoo!mail 也使用Ajax 技术将邮箱作的象outlook;进一步的,百度的安全中心,更是利用网页安装杀毒引擎到用户桌面,但通过本地的Web服务,使用网页作为查杀病毒的控制界面!
因为,人们越来越多的将时间化在网络中,通过浏览器,在网页中写作/沟通/购物/工作/学习/游戏,,,网页作为操纵信息的界面,人家已经非常非常习惯和熟练了;
而且,网页,基于简单的HTML设计和解析,比使用操作系统的图形接口来绘制用户界面要轻松的多的多!
所以,行者也建议,能愉懒使用网页作为GUI时,千万不要客气!

王道?简洁!

Kingcraft means simple!

KISS 才是王道!来自 [:ObpLovelyPython/CDay3:CDay +3 应用多线程再次优化]

背景

KISS 概念

解说

有关软件设计经验
所谓:"少即是多"

由建筑大师密斯.凡.德.罗提出的：“少即是多（Less is more）。”但又绝不是简单得像白纸一张，让你觉得空洞无物，根本就没有设计。奥卡姆的威廉是14世纪英国的逻辑学家、圣芳济会修士。他提出了“简洁原则”（les parsimoniae）。这个原则认为整体应当控制在必须的范围内。其“奥卡姆剃刀原理”（Occam’s razor）这样陈述：当一个现象有两个相当的合理解释时，它应当采用简洁的那个。

想象;无垠!

Imagine Unlimited!

想象力才是 Pythoner 的唯一界限 来自 [:ObpLovelyPython/CDayN:CDay +N 基于Python的无尽探索]

背景
解说: 有关资源深度利用经验~ 社区，交流，搜索，知识管理策略 ...

感到不爽,自个儿尝试相应工具解决了,并及时分享出来,是态度0！感到不爽,自个儿尝试找到解决方案了,并及时分享出来,是态度1！感到不爽,自个儿尝试修订代码搞定了,并及时分享出来,是态度2！感到不爽,自个儿未经尝试直接出来吼,期望行者来解决,是最不靠谱态度!

箴言凝练

一切尽在自言中:

蠎之禅

图 atta1-2 Python 内置的哲学诗文

attachment:atta1-2.png

在线的汉化版本收集:
- 访问地址: http://wiki.woodpecker.org.cn/moin/PythonZen
- 精巧地址: http://bit.ly/2h4f5T

美丽好过丑陋;
浅显好过隐晦;
简单好过复合;
复合好过复杂;
扁平好过嵌套;
稀疏好过密集;
可读性最重要;
即便实用性比纯度重要,
但是!特殊案例不可特殊到打破规则;
错误从来不会默默消失,
得由人明确的让它闭嘴!
面对模糊,拒绝猜测的诱惑;
应该有一个(宁愿只有一个)显而易见的解决方法;
尽管刚开始方法不会是很明显,即使永远不做比"立刻"做要"聪明",
但是！现在就做永远比不做要好;
只要实现很难解释,那么它就不是一个好主意;
只要实现很容易解释,那么这就是一个好主意;
名称空间是个绝妙想法.
--大家一起来实践这些规则吧!

-- by Tim Peters

我们的奋起宣言

每日至少抽一刻钟,解答邮件列表中初学者的问题，
每周至少抽两小时,整理新学知识将体验发表/分享出去，
    通过Blog/Wiki/MaiList/个人网站……
每旬至少抽四个小时, 来翻译自个儿喜爱的自由软件的文档，
每月至少抽八小时, 快乐的编程，推进自个儿的项目，
每年至少参加一次, 自由软件的活动，传播自由软件思想，
    发展一名“自由人”……

只要我们每个人都坚持下去……
10年！就足以改变中国软件的整体风貌！

访问地址: http://wiki.woodpecker.org.cn/moin/RouseChina
精巧地址: http://bit.ly/DSYYt

::-- ZoomQuiet [DateTime(2007-11-03T11:46:56Z)] PageComment2

ObpLovelyPython/LpyAttach1motto

行者箴言

用之,不学!

寻之!不造.

否之!守之!

发布,持续!

先用,再修,

网站?软件!

王道?简洁!

想象;无垠!

箴言凝练

蠎之禅

我们的奋起宣言