自制Python函数帮助查询小工具

开发 后端 前端
鉴于此,我决定自己做一个小工具,花费较小的系统代价来方便的查询各种函数和模组的功能。这里只给出一个能使用的版本。开放源代码给大家,代码风格和控件设计可供初学者模仿。

Python的自带文档功能很不错,给与我耳目一新的感觉。如果在CMD中进行“行式编程”编程的话,可以随时随地的查询函数的功能,非常方便。比如在学习list、tuple、dict、str、os、sys等模组的时候,利用Python的自带文档可以很快速的全面的学到那些处理的函数。所以这个自带文档功能能够给出学者带来很大的方便之处,进行简短的开发是再好不过的。

但是,当你离开CMD,要利用IDLE或者要用Komodo Edit等软件进行“段式编程”的时候,就有些捉襟见肘了。例如,wx库非常之大,帮助文件有10MB之多,如果你在CMD中打开,你可以想想你需要多少时间才能够查看到你想要的帮助信息。大规模的熟悉Python的各种API之后,你会发现,这个并不是想象的那么好用。不断的按任意键进行翻页,同时页面内能够容纳的页面也有限。所以表现出非常大的不便之处。

这里大概有两种方法解决。

***,使用Module Docs工具

这个工具是Python GUI IDLE自带的一个查询帮助文件的方法。在里面可以利用网页的形式,利用本机的本地功能,提供一个模拟在线的一个查询方法。它可以打开一个网页,上面可以显示出所有的函数,并带有规范的分类,比较清楚,但是使用起来还是不方便,毕竟没有搜索功能。如果将查到的网页内容保存链接,那么是不可以持续使用的。所以这个就有很大的问题,同时,其生成的网页文件巨大,内存太小是会给系统带来压力。所以这个方法并不是一个可以很方便使用的方法。

第二,自己开发工具

其实我也不愿意自己开发工具,因为这个毕竟需要时间,几天时间或者几个周的时间说少也少,说多也多,而且给自己的内心产生的压力也不小,毕竟需要分心不少来做这个事情。我在网上找了很长时间,都没有找到,对于wx,我找到一个wxPython API的英文文档,上面介绍的很不清楚,非常模糊,直接列出了函数和具体的参数,如何使用基本很少提及,而且很多控件的各种style也没有详细列举出来。所以是很不好用的,如果是名字忘掉了,那还可以查一下完整的单词和详细的参数列表。其他的功能就完全很少涉及到了。

鉴于此,我决定自己做一个小工具,花费较小的系统代价来方便的查询各种函数和模组的功能。这里只给出一个能使用的版本。开放源代码给大家,代码风格和控件设计可供初学者模仿。高手愿意来批评我,我洗耳恭听。后续版本也会发布在这里,到时候可能就先封装之后在发布,现在发布的这个是源代码文件,大家都知道,Python的源代码文件双击即可执行。

  1. #coding=utf-8  
  2. #功能介绍:本软件最初只用于模块和函数用法的查询,进行快速的显示  
  3. #扩展功能:可以将查询成功的结果保存到本地,  
  4. #          将里面的部分函数使用汉语进行注释之后的结果保存下来  
  5. #          以保存的关键字放于右侧列表  
  6. #深度扩展:使用数据库保存结果,并提供增删查改的接口  
  7.  
  8. from Tkinter import *  
  9. from StringIO import StringIO  
  10. from tkSimpleDialog import *  
  11. import sys  
  12. import Pmw  
  13. import ConfigParser  
  14. import os  
  15. import wx  
  16.  
  17. class Finder(Frame):  
  18.  
  19.     def OnFind(self):  
  20.         #执行,并获取结果  
  21.         info = self.inputStr.get()  
  22.         if len(info)==0:  
  23.             return True 
  24.         buff =StringIO()  
  25.         temp = sys.stdout    #保存标准I/O流  
  26.         sys.stdout = buff    #将标准I/O流重定向到buff对象  
  27.         self.text.delete(1.0, END)  
  28.         try:  
  29.             fmt = 'help('+info+')' 
  30.             result = eval(fmt)  
  31.             self.text.insert(1.0, buff.getvalue())  
  32.             self.savebtn.config(state=NORMAL)  
  33.         except:  
  34.             try:  
  35.                 __import__(info)  
  36.  
  37.                 fmt = 'help('+self.inputStr.get()+')' 
  38.                 result = eval(fmt)  
  39.                 self.text.insert(1.0, buff.getvalue())  
  40.             except:  
  41.                 self.text.insert(1.0,"ERROR.")  
  42.         sys.stdout =temp     #恢复标准I/O流buff.getvaue()  
  43.         self.helpbtn.config(state=NORMAL)  
  44.  
  45.          
  46.     def save(self):  
  47.         #搜索,如果没有找到就保存,使用ini文件进行,保存数据  
  48.         #保存原始  
  49.         tofind = self.inputStr.get()  
  50.         if len(tofind)==0:  
  51.             return 
  52.         filename='s_'+tofind+'.ini' 
  53.         fout = open(filename,'w')  
  54.         fout.write(self.text.get(1.0, END).encode('utf-8'))  
  55.         fout.close()  
  56.           
  57.         self.items.append(tofind)  
  58.         self.items.sort()  
  59.         self.config.add_section(tofind)  
  60.         self.config.write(open('data.ini''r+'))  
  61.           
  62.         nindex = self.items.index(tofind)  
  63.         self.box.delete(0,END)  
  64.         self.box.insert(0, *self.items)  
  65.         self.box.see(nindex)  
  66.         self.box.selection_set(nindex)  
  67.  
  68.         self.savebtn.config(state=DISABLED)  
  69.  
  70.     def saveas(self):  
  71.         #保存修改  
  72.         index = self.box.curselection()   
  73.         if index<0:  
  74.             return             
  75.         tofind = self.box.get(index)  
  76.         if len(tofind)==0:  
  77.             return 
  78.         strinfo = self.text.get(1.0, END)  
  79.  
  80.         filename='s_'+tofind+'.ini' 
  81.         fout = open(filename,'w')  
  82.         fout.write(strinfo.encode("UTF-8"))  
  83.         fout.close()    
  84.  
  85.         self.saveasbtn.config(state=DISABLED)  
  86.  
  87.     def __init__(self):  
  88.         Frame.__init__(self)  
  89.         self.option_add('*Font''Verdana 12 bold')  
  90.         self.pack(expand=YES, fill=BOTH)  
  91.         self.master.title(u'Python函数查询器')  
  92.         self.master.iconname("calc1")  
  93.  
  94.         #左侧列表,放置已保存的条目,按照字母顺序排序  
  95.         infoF = Frame(self)  
  96.         infoF.pack(side=LEFT,expand=NO, fill=BOTH)  
  97.  
  98.         listF = Frame(infoF)  
  99.         listF.pack(side=TOP,expand=YES, fill=BOTH)  
  100.  
  101.         #获取项目  
  102.         self.config = ConfigParser.ConfigParser()  
  103.         self.config.read('data.ini')  
  104.         self.items = self.config.sections()  
  105.         self.items.sort()  
  106.         self.box = Listbox(listF,width=15,selectmode=SINGLE)  
  107.         self.box.insert(0, *self.items)  
  108.         self.box.bind('<ButtonRelease-1>',self.selectionCommand)#使用鼠标释放消息  
  109.         self.box.bind('<ButtonRelease-3>',self.boxrightmenu)#使用右键菜单删除项目  
  110.  
  111.         self.PopupMenu=Menu(listF)  
  112.         self.PopupMenu.add_command(label=u'删除',command=self.deleteitem)  
  113.         self.PopupMenu.add_command(label=u'重命名',command=self.renameitem)  
  114.         self.box.pack(side=LEFT,expand=YES,fill=BOTH)  
  115.           
  116.         self.slbar = Scrollbar(listF, orient=VERTICAL, command=self.box.yview)  
  117.         self.slbar.pack(side=RIGHT, expand=NO, fill=BOTH)  
  118.         self.box.configure(yscrollcommand=self.slbar.set)  
  119.           
  120.         btnf = Frame(infoF)  
  121.         btnf.pack(side=BOTTOM, fill=BOTH)  
  122.         self.savebtn = Button(btnf, text=u'新建保存',state=DISABLED, command=self.save)  
  123.         self.savebtn.pack(side=LEFT, expand=YES, fill=BOTH)          
  124.         self.saveasbtn = Button(btnf, text=u'保存修改',state=DISABLED, command=self.saveas)  
  125.         self.saveasbtn.pack(side=RIGHT, expand=YES, fill=BOTH)  
  126.  
  127.  
  128.         #包括列表信息和显示信息  
  129.         twoF = Frame(self)  
  130.         twoF.pack(side=BOTTOM, expand=YES, fill=BOTH)  
  131.           
  132.         #显示信息、滚动条  
  133.         showF = Frame(twoF, relief=SUNKEN)  
  134.         self.text = Text(showF,height=25, width =65)  
  135.         self.text.insert(1.0,'information...')  
  136.         self.text.pack(side=LEFT, expand=YES, fill=BOTH)     
  137.         self.text.bind("<Key>"self.modify)    
  138.         self.text.bind("<Double-Button-1>"self.tomodify)  
  139.         self.ismodified = False 
  140.         showF.pack(side=TOP,expand=YES, fill=BOTH)  
  141.  
  142.         self.scrollbar = Scrollbar(showF, orient=VERTICAL, command=self.text.yview)  
  143.         self.scrollbar.pack(side=RIGHT, expand=NO, fill=BOTH)  
  144.         self.text.configure(yscrollcommand=self.scrollbar.set)  
  145.  
  146.         #提供输入接口,和功能如:查找  
  147.         inputF = Frame(twoF)  
  148.         inputF.pack(side=BOTTOM, fill=BOTH)  
  149.         self.inputStr = StringVar()  
  150.         self.inputStr.set('')  
  151.         self.info = StringVar()  
  152.         self.info.set('infomation...')  
  153.         self.entry = Entry(inputF, relief=SUNKEN, textvariable=self.inputStr)  
  154.         self.entry.bind("<Return>"self.inputreturn)  
  155.         self.entry.pack(side=LEFT, expand=YES, fill=BOTH)  
  156.           
  157.         self.findbtn = Button(inputF,text=u'查找',command=self.OnFind)  
  158.         self.findbtn.pack(side=LEFT, expand=YES, fill=BOTH)  
  159.         self.helpbtn = Button(inputF,text=u'帮助',command=self.OnHelp)  
  160.         self.helpbtn.pack(expand=NO, fill=Y)  
  161.  
  162.     def OnHelp(self):  
  163.         fp = open('readme.txt')  
  164.         buff = fp.read()  
  165.         fp.close()  
  166.  
  167.         self.text.delete(1.0, END)  
  168.         self.text.insert(1.0, buff)     
  169.         self.helpbtn.config(state=DISABLED)  
  170.  
  171.     def deleteitem(self):  
  172.         #右键菜单, 删除功能  
  173.         sels = self.box.curselection()  
  174.         if len(sels) == 0:  
  175.             pass #print 'no selection'  
  176.         else:  
  177.             sec = self.items[int(sels[0])]  
  178.             self.config.remove_section(sec)  
  179.             self.config.write(open('data.ini''w'))  
  180.             self.box.delete(sels[0])  
  181.      #       self.items.remove(sels[0])     #是引用效果  
  182.             self.text.delete(1.0, END)  
  183.             self.text.insert(1.0,'delete success.')  
  184.               
  185.  
  186.     def renameitem(self,event=None,en=None):  
  187.         #邮件菜单, 重命名功能  
  188.         retval = askstring("input",  
  189.                     "input the new name:")  
  190.         if len(retval)==0:  
  191.             return 
  192.         sels = self.box.curselection()  
  193.         if len(sels) == 0:  
  194.             pass #print 'no selection'  
  195.         else:  
  196.             #数组/表/配置文件  
  197.             sec = self.items[int(sels[0])]  
  198.  
  199.             self.box.delete(0, END)  
  200.             self.items[int(sels[0])] = retval    #数组  
  201.             self.items.sort()  
  202.             self.box.insert(0, *self.items)     #表  
  203.               
  204.             self.config.remove_section(sec)  
  205.             self.config.add_section(retval)  
  206.             self.config.write(open('data.ini''w'))    #配置文件  
  207.               
  208.             self.text.delete(1.0, END)  
  209.             self.text.insert(1.0,'rename success.')  
  210.               
  211.       
  212.     def boxrightmenu(self,event=None,en=None):  
  213.         #弹出右键菜单  
  214.         self.PopupMenu.tk_popup(*self.winfo_pointerxy())  
  215.       
  216.     def tomodify(self,event=None,en=None):  
  217.         if self.ismodified==True:  
  218.             self.saveasbtn.config(state=DISABLED)  
  219.             self.ismodified = False 
  220.         else:  
  221.             self.saveasbtn.config(state=NORMAL)  
  222.             self.ismodified = True 
  223.         return True 
  224.       
  225.     def modify(self,event=None,en=None):              
  226.         self.saveasbtn.config(state=NORMAL)  
  227.         return True 
  228.  
  229.     def inputreturn(self,event=None,en=None):  
  230.         self.OnFind()  
  231.         return True 
  232.           
  233.     def selectionCommand(self,event=None,en=None):  
  234.         # 选中列表时, 显示详细内容  
  235.         sels = self.box.curselection()  
  236.         if len(sels) == 0:  
  237.             pass   
  238.         else:  
  239.             filename='s_'+self.box.get(sels[0])+'.ini' 
  240.             fp = open(filename)  
  241.             strinfo = fp.read()  
  242.             fp.close()  
  243.             self.text.delete(1.0, END)  
  244.             self.text.insert(1.0,strinfo)  
  245.         self.helpbtn.config(state=NORMAL)  
  246.  
  247. if __name__ == '__main__':  
  248.     Finder().mainloop()  

注意事项,源代码文件如果想要正确执行,请自己建立一个readme.txt文件,和data.ini文件。否则将会因为这两个文件打不开而出错。为什么没有使用异常处理呢?我没有没有完善到那一步。现在这个版本已经可以使用了,所以大家不防试试看。

【注意】:打开软件后,请输入list、tuple、dict等类型进行查询,点击新建保存即可保存到列表,供下次快速打开。

有的包在源代码中没有包括,如codecs。这个时候你需要手动的将这个包添加到源文件的开头,才能够查询到,如:import codecs。

如果你修改了显示框中的文本,请及时点击保存修改进行保存,以便下次打开还可以看到你修改的效果。

本版本并不完善,而且功能有限,本身基于Python做的,所以其价值还是作为Python开发应用实例为主。
 

原文链接:http://www.cnblogs.com/Hiker/archive/2011/03/09/funfind.html

【编辑推荐】

  1. 巧用IronPython做更灵活的网页爬虫
  2. Python 3.2发布 改进调试器PDB
  3. 浅谈Python Web的五大框架
  4. 一个Python程序员的进化
  5. 年度黑马Python 自省指南
责任编辑:陈贻新 来源: 布同的博客
相关推荐

2019-06-24 09:55:32

MySQLSQL优化

2009-11-19 08:48:10

Windows 7桌面工具

2010-07-01 10:24:30

UML小工具

2009-12-08 14:02:25

Windows 7小工

2021-05-20 11:30:17

Python工具代码

2020-11-26 12:05:44

Python小工具代码

2021-05-10 11:06:31

Python工具代码

2019-11-01 11:12:50

PythonExcelWindows

2022-03-30 15:11:26

Python房价工具

2013-03-29 14:46:33

App开发小工具辅助工具

2009-07-07 08:49:33

微软Windows 7新功能

2013-12-16 17:25:08

KDEGNOME桌面应用

2017-07-25 14:20:13

戴尔配置功耗

2022-12-28 12:29:45

duf命令

2022-05-31 09:42:49

工具编辑器

2020-02-14 11:00:59

开发者技能工具

2011-11-30 16:31:00

TimZon

2011-04-12 12:53:17

2010-05-19 19:10:42

2021-11-05 06:57:50

架构工具代码
点赞
收藏

51CTO技术栈公众号