python的即時標記項目練習(xí)筆記

更新時間：2014年09月18日 12:02:28 投稿：junjie

這篇文章主要介紹了python的即時標記項目練習(xí)筆記,本文是閱讀《python基礎(chǔ)教程》一書的動手實踐項目,需要的朋友可以參考下

這是《python基礎(chǔ)教程》后面的實踐，照著寫寫，一方面是來熟悉python的代碼方式，另一方面是練習(xí)使用python中的基本的以及非基本的語法，做到熟能生巧。

這個項目一開始比較簡單，不過重構(gòu)之后就有些復(fù)雜了，但是更靈活了。

按照書上所說，重構(gòu)之后的程序，分為四個模塊：處理程序模塊，過濾器模塊，規(guī)則（其實應(yīng)該是處理規(guī)則），語法分析器。

先來說處理程序模塊，這個模塊的作用有兩個，一個是提供那些固定的html標記的輸出（每一個標記都有start和end），另一個是對這個標記輸出的開始和結(jié)束提供了一個友好的訪問接口。來看下程序handlers.py：

復(fù)制代碼代碼如下:

class Handler:
    '''
    '''
    def callback(self, prefix, name, *args):
        method = getattr(self,prefix+name,None)
        if callable(method): return method(*args)
    def start(self, name):
        self.callback('start_', name)
    def end(self, name):
        self.callback('end_', name)
    def sub(self, name):
        def substitution(match):
            result = self.callback('sub_', name, match)
            if result is None: match.group(0)
            return result
        return substitution

class HTMLRenderer(Handler):
'''

    '''
    def start_document(self):
        print '<html><head><title>...</title></head><body>'
    def end_document(self):
        print '</body></html>'
    def start_paragraph(self):
        print '<p>'
    def end_paragraph(self):
        print '</p>'
    def start_heading(self):
        print '<h2>'
    def end_heading(self):
        print '</h2>'
    def start_list(self):
        print '<ul>'
    def end_list(self):
        print '</ul>'
    def start_listitem(self):
        print '<li>'
    def end_listitem(self):
        print '</li>'
    def start_title(self):
        print '<h1>'
    def end_title(self):
        print '</h1>'
    def sub_emphasis(self, match):
        return '<em>%s</em>' % match.group(1)
    def sub_url(self, match):
        return '<a href="%s">%s</a>' % (match.group(1),match.group(1))
    def sub_mail(self, match):
        return '<a href="mailto:%s">%s</a>' % (match.group(1),match.group(1))
    def feed(self, data):
        print data

這個程序堪稱是整個“項目”的基石所在：提供了標簽的輸出，以及字符串的替換。理解起來也比較簡單。

再來看第二個模塊“過濾器”，這個模塊更為簡單，其實就是一個正則表達式的字符串。相關(guān)代碼如下：

復(fù)制代碼代碼如下:

self.addFilter(r'\*(.+?)\*', 'emphasis')

self.addFilter(r'(http://[\.a-z0-9A-Z/]+)', 'url')

self.addFilter(r'([\.a-zA-Z]+@[\.a-zA-Z]+[a-zA-Z]+)','mail')

這就是三個過濾器了，分別是：強調(diào)牌過濾器（用×號標出的），url牌過濾器，email牌過濾器。熟悉正則表達式的同學(xué)理解起來是沒有壓力的。

再來看第三個模塊“規(guī)則”，這個模塊，拋開那祖父類不說，其他類應(yīng)該有的兩個方法是condition和action，前者是用來判斷讀進來的字符串是不是符合自家規(guī)則，后者是用來執(zhí)行操作的，所謂的執(zhí)行操作就是指調(diào)用“處理程序模塊”，輸出前標簽、內(nèi)容、后標簽。來看下這個模塊的代碼，其實這個里面幾個類的關(guān)系，畫到類圖里面看會比較清晰。 rules.py:

復(fù)制代碼代碼如下:

class Rule:
    def action(self, block, handler):
        handler.start(self.type)
        handler.feed(block)
        handler.end(self.type)
        return True

class HeadingRule(Rule):
    type = 'heading'
    def condition(self, block):
        return not '\n' in block and len(block) <= 70 and not block[-1] == ':'

class TitleRule(HeadingRule):
type = 'title'
first = True

    def condition(self, block):
        if not self.first: return False
        self.first = False
        return HeadingRule.condition(self, block)

class ListItemRule(Rule):
    type = 'listitem'
    def condition(self, block):
        return block[0] == '-'
    def action(self,block,handler):
        handler.start(self.type)
        handler.feed(block[1:].strip())
        handler.end(self.type)
        return True

class ListRule(ListItemRule):
    type = 'list'
    inside = False
    def condition(self, block):
        return True
    def action(self,block, handler):
        if not self.inside and ListItemRule.condition(self,block):
            handler.start(self.type)
            self.inside = True
        elif self.inside and not ListItemRule.condition(self,block):
            handler.end(self.type)
            self.inside = False
        return False

class ParagraphRule(Rule):
    type = 'paragraph'
    def condition(self, block):
        return True

補充utils.py:

復(fù)制代碼代碼如下:

def line(file):
for line in file:yield line
yield '\n'

def blocks(file):
    block = []
    for line in lines(file):
        if line.strip():
            block.append(line)
        elif block:
            yield ''.join(block).strip()
            block = []

最后隆重的來看下“語法分析器模塊”，這個模塊的作用其實就是協(xié)調(diào)讀入的文本和其他模塊的關(guān)系。在往重點說就是，提供了兩個存放“規(guī)則”和“過濾器”的列表，這么做的好處就是使得整個程序的靈活性得到了極大的提高，使得規(guī)則和過濾器變成的熱插拔的方式，當(dāng)然這個也歸功于前面在寫規(guī)則和過濾器時每一種類型的規(guī)則（過濾器）都單獨的寫成了一個類，而不是用if..else來區(qū)分。看代碼：

復(fù)制代碼代碼如下:

import sys, re
from handlers import *
from util import *
from rules import *

class Parser:
    def __init__(self,handler):
        self.handler = handler
        self.rules = []
        self.filters = []

def addRule(self, rule):
self.rules.append(rule)

    def addFilter(self,pattern,name):
        def filter(block, handler):
            return re.sub(pattern, handler.sub(name),block)
        self.filters.append(filter)

    def parse(self, file):
        self.handler.start('document')
        for block in blocks(file):
            for filter in self.filters:
                block = filter(block, self.handler)
            for rule in self.rules:
                if rule.condition(block):
                    last = rule.action(block, self.handler)
                    if last:break
        self.handler.end('document')

class BasicTextParser(Parser):
    def __init__(self,handler):
        Parser.__init__(self,handler)
        self.addRule(ListRule())
        self.addRule(ListItemRule())
        self.addRule(TitleRule())
        self.addRule(HeadingRule())
        self.addRule(ParagraphRule())

        self.addFilter(r'\*(.+?)\*', 'emphasis')
        self.addFilter(r'(http://[\.a-z0-9A-Z/]+)', 'url')
        self.addFilter(r'([\.a-zA-Z]+@[\.a-zA-Z]+[a-zA-Z]+)','mail')

handler = HTMLRenderer()
parser = BasicTextParser(handler)

parser.parse(sys.stdin)

這個模塊里面的處理思路是，遍歷客戶端（也就是程序執(zhí)行的入口）給插進去的所有的規(guī)則和過濾器，來處理讀進來的文本。

有一個細節(jié)的地方也要說一下，其實是和前面寫的呼應(yīng)一下，就是在遍歷規(guī)則的時候通過調(diào)用condition這個東西來判斷是否符合當(dāng)前規(guī)則。

我覺得這個程序很像是命令行模式，有空可以復(fù)習(xí)一下該模式，以保持記憶網(wǎng)節(jié)點的牢固性。

最后說一下我以為的這個程序的用途:

1、用來做代碼高亮分析，如果改寫成js版的話，可以做一個在線代碼編輯器。
2、可以用來學(xué)習(xí)，供我寫博文用。

還有其他的思路，可以留下您的真知灼見。
補充一個類圖，很簡陋，但是應(yīng)該能說明之間的關(guān)系。另外我還是建議如果看代碼捋不清關(guān)系最好自己畫圖，自己畫圖才能熟悉整個結(jié)構(gòu)。