首页 > 代码库 > 可爱的Python_课后习题_CDay0 时刻准备着!发布

可爱的Python_课后习题_CDay0 时刻准备着!发布

请根据软件发布的流程和软件开发的编码规范,将读者在前面章节所写的程序修改并发 布出去。另外,可以查找下除了 epydoc 外还有哪些较好的 py 文档生成器? 

pydoc是Python自带的模块,主要用于从python模块中自动生成文档,这些文档可以基于文本呈现的、也可以生成WEB 页面的,还可以在服务器上以浏览器的方式呈现!

[用法]

Windows下:

D:>python -m pydoc # 比如说: python -m pydoc math 
-m参数:Python以脚本的方法运行模块

[帮助]

pydoc < name > …

Show text documentation on something.  <name> may be the name of a Python keyword, topic, function, module, or package, or a dotted reference to a class or function within a module or module in a
package.  If <name> contains a ‘/‘, it is used as the path to a Python source file to document. If name is ‘keywords‘, ‘topics‘, or ‘modules‘, a listing of these things is displayed.

pydoc -w < name > …

Write out the HTML documentation for a module to a file in the current directory.  If <name> contains a ‘/‘, it is treated as a filename; if it names a directory, documentation is written for all the contents.

python代码(Test.py):

#encoding=utf-8

"""
进行堆栈的操作
"""

__authors__= "test"

class Stack:
    """堆栈"""
    items = list()

    def put(self, item):
        """将数据压入堆栈中"""
        self.items.append(item)


    def get(self):
        """将数据从堆栈中取出"""
        length = len(self.items)
        item = self.items[length-1]
        self.items.remove(item)
        return item

cmd  中输入  D:\Learn\Python> python -m pydoc Test 

<style>p.p1 { margin: 0.0px 0.0px 0.0px 0.0px; font: 11.0px Menlo; color: #000000; background-color: #ffffff; min-height: 13.0px } p.p2 { margin: 0.0px 0.0px 0.0px 0.0px; font: 11.0px Menlo; color: #000000; background-color: #ffffff } span.s1 { }</style>

 

Help on module Test:

 

NAME

    Test - 进行堆栈的操作

 

FILE

    /Users/jiajie.djj/workbench/zhu/Test.py

 

CLASSES

    Stack

    

    class Stack

     |  堆栈

     |  

     |  Methods defined here:

     |  

     |  get(self)

     |      将数据从堆栈中取出

     |  

     |  put(self, item)

     |      将数据压入堆栈中

     |  

     |  ----------------------------------------------------------------------

 

 

<style>p.p1 { margin: 0.0px 0.0px 0.0px 0.0px; font: 11.0px Menlo; color: #000000; background-color: #ffffff } p.p2 { margin: 0.0px 0.0px 0.0px 0.0px; font: 11.0px Menlo; color: #000000; background-color: #ffffff; min-height: 13.0px } span.s1 { }</style>

 |  ----------------------------------------------------------------------

     |  Data and other attributes defined here:

     |  

     |  items = []

 

DATA

    __authors__ = ‘test‘

 

 

cmd 中输入 D:\Learn\Python> python -m pydoc -w Test Test.html

 

 技术分享

 

 

可爱的Python_课后习题_CDay0 时刻准备着!发布