小編給大家分享一下linux中怎么利用CTags開發(fā)一個(gè)Sublime Text代碼補(bǔ)完插件,相信大部分人都還不怎么了解,因此分享這篇文章給大家參考一下,希望大家閱讀完這篇文章后大有收獲,下面讓我們一起去了解一下吧!
成都創(chuàng)新互聯(lián)從2013年創(chuàng)立,是專業(yè)互聯(lián)網(wǎng)技術(shù)服務(wù)公司,擁有項(xiàng)目網(wǎng)站制作、成都網(wǎng)站制作網(wǎng)站策劃,項(xiàng)目實(shí)施與項(xiàng)目整合能力。我們以讓每一個(gè)夢想脫穎而出為使命,1280元尉犁做網(wǎng)站,已為上家服務(wù),為尉犁各地企業(yè)和個(gè)人服務(wù),聯(lián)系電話:13518219792
剛開始接觸 Sublime Text 插件的編寫,當(dāng)然需要先了解 Sublime Text 提供的各種接口,為此,我去 Sublime Text 的官網(wǎng)找到了相關(guān)文檔:How to Create a Sublime Text Plugin,以及 Sublime Text Unofficial Documentation。
首先,在 Sublime Text 中選擇 “Tools -> Developer -> New Plugin” 新建一個(gè)最基本的插件文檔:
import sublimeimport sublime_plugin class ExampleCommand(sublime_plugin.TextCommand): def run(self, edit): self.view.insert(edit, 0, "Hello, World!")
這里的 sublime
和 sublime_plugin
是 Sublime 必需的模塊,其中具體的類和方法可以參考官方的 API Reference。
接著,把這個(gè)文件保存到 Package
文件夾(默認(rèn)的保存位置 User
文件夾的上一層)的 CTagsAutoComplete
文件夾(新建)下,并命名為 CTagsAutoComplete.py
。盡管命名并沒有什么限制,但***還是以插件的名稱來統(tǒng)一命名。
然后回到 Sublime Text 中,通過快捷鍵 Ctrl+`
進(jìn)入 Sublime Text 的 Command Console,然后輸入 view.run_command('example')
,如果下方顯示 “Hello World”,說明插件已經(jīng)正常加載。
這里之所以直接用
'example'
,是因?yàn)?Command 命令的名稱是根據(jù)大寫字符進(jìn)行拆分的,例子中的ExampleCommand
在 Command 中 為'example_command'
,直接輸入'example'
也可以訪問。
Window
:Sublime Text 的當(dāng)前窗口對象
View
:Sublime Text 當(dāng)前窗口中打開的視圖對象
Command Palette
:Sublime Text 中通過快捷鍵 Ctrl+Shift+P
打開的交互式列表
Sublime Text 下的插件命令有 3 種命令類型(都來自于 sublime_plugin
模塊):
TextCommand Class:通過 View
對象提供對選定文件/緩沖區(qū)的內(nèi)容的訪問。
WindowCommand Class:通過 Window
對象提供當(dāng)前窗口的引用
ApplicationCommand Class:這個(gè)類沒有引用任何特定窗口或文件/緩沖區(qū),因此很少使用
2 種事件監(jiān)聽類型:
EventListener Class:監(jiān)聽 Sublime Text 中各種事件并執(zhí)行一次命令
ViewEventListener Class:為 EventListener
提供類似事件處理的類,但綁定到特定的 view。
2 種輸入處理程序:
TextInputHandler Class:可用于接受 Command Palette 中的文本輸入。
ListInputHandler Class:可用于接受來自 Command Palette 中列表項(xiàng)的選擇輸入。
因?yàn)槲乙獙?shí)現(xiàn)的功能比較簡單,只需要監(jiān)聽輸入事件并觸發(fā)自動完成功能,因此需要用到 EventListener Class
。在該類下面找到了 on_query_completions
方法用來處理觸發(fā)自動完成時(shí)執(zhí)行的命令。接著修改一下剛才的代碼:
import sublimeimport sublime_plugin class CTagsAutoComplete(sublime_plugin.EventListener): def on_query_completions(self, view, prefix, locations):
view
:當(dāng)前視圖
prefix
:觸發(fā)自動完成時(shí)輸入的文字
locations
: 觸發(fā)自動完成時(shí)輸入在緩存區(qū)中的位置,可以通過這個(gè)參數(shù)判斷語言來執(zhí)行不同命令
返回類型:
return None
return [["trigger \t hint", "contents"]...]
,其中 \t hint
為可選內(nèi)容,給自動完成的函數(shù)名稱添加一個(gè)提示
return (results, flag)
,其中 results
是包含自動完成語句的 list,如上;flag
是一個(gè)額外參數(shù),可用來控制是否顯示 Sublime Text 自帶的自動完成功能
為了讀取 .tag 文件,首先得判斷當(dāng)前項(xiàng)目是否打開,同時(shí) .tag 文件是否存在,然后讀取 .tag 文件中的所有內(nèi)容:
import sublimeimport sublime_pluginimport osimport re class CTagsAutoComplete(sublime_plugin.EventListener): def on_query_completions(self, view, prefix, locations): results = [] ctags_paths = [folder + '\.tags' for folder in view.window().folders()] ctags_rows = [] for ctags_path in ctags_paths: if not is_file_exist(view, ctags_path): return [] ctags_path = str(ctags_path) ctags_file = open(ctags_path, encoding = 'utf-8') ctags_rows += ctags_file.readlines() ctags_file.close() def is_file_exist(view, file): if (not view.window().folders() or not os.path.exists(file)): return False return True
通過上述操作,即可讀取當(dāng)前項(xiàng)目下所有的 .tag 文件中的內(nèi)容。
首先是獲取 .tags 文件中,包含 prefix
的行:
for rows in ctags_rows: target = re.findall('^' + prefix + '.*', rows)
一旦找到,就通過正則表達(dá)式對該行數(shù)據(jù)進(jìn)行處理:
if target: matched = re.split('\t', str(target[0])) trigger = matched[0] # 返回的***個(gè)參數(shù),函數(shù)名稱 trigger += '\t(%s)' % 'CTags' # 給函數(shù)名稱后加上標(biāo)識 'CTags' contents = re.findall(prefix + '[0-9a-zA-Z_]*\(.*\)', str(matched[2])) # 返回的第二個(gè)參數(shù),函數(shù)的具體定義 if (len(matched) > 1 and contents): results.append((trigger, contents[0])) results = list(set(results)) # 去除重復(fù)的函數(shù) results.sort() # 排序
處理完成之后就可以返回了,考慮到***只顯示 .tags 中的函數(shù),我不需要顯示 Sublime Text 自帶的自動完成功能(提取當(dāng)前頁面中的變量和函數(shù)),因此我的返回結(jié)果如下:
return (results, sublime.INHIBIT_WORD_COMPLETIONS | sublime.INHIBIT_EXPLICIT_COMPLETIONS)
考慮到能夠關(guān)閉插件的功能,因此需要添加一個(gè)配置文件,用來指定不開啟插件功能的語言,這里我參考了 “All AutoComplete” 的代碼:
def plugin_loaded(): global settings settings = sublime.load_settings('CTagsAutoComplete.sublime-settings') def is_disabled_in(scope): excluded_scopes = settings.get("exclude_from_completion", []) for excluded_scope in excluded_scopes: if scope.find(excluded_scope) != -1: return True return False if is_disabled_in(view.scope_name(locations[0])): return []
這里用到的配置文件需要添加到插件所在的文件夾中,名稱為 CTagsAutoComplete.sublime-settings
,其內(nèi)容為:
{ // An array of syntax names to exclude from being autocompleted. "exclude_from_completion": [ "css", "html" ]}
有了配置文件,還需要在 Sublime Text 的 “Preferences -> Package settings” 下添加相應(yīng)的設(shè)置,同樣也是放在插件所在文件夾中,名稱為 Main.sublime-menu
:
[ { "caption": "Preferences", "mnemonic": "n", "id": "preferences", "children": [ { "caption": "Package Settings", "mnemonic": "P", "id": "package-settings", "children": [ { "caption": "CTagsAutoComplete", "children": [ { "command": "open_file", "args": { "file": "${packages}/CTagsAutoComplete/CTagsAutoComplete.sublime-settings" }, "caption": "Settings" } ] } ] } ] }]
以上是“l(fā)inux中怎么利用CTags開發(fā)一個(gè)Sublime Text代碼補(bǔ)完插件”這篇文章的所有內(nèi)容,感謝各位的閱讀!相信大家都有了一定的了解,希望分享的內(nèi)容對大家有所幫助,如果還想學(xué)習(xí)更多知識,歡迎關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道!
分享名稱:linux中怎么利用CTags開發(fā)一個(gè)SublimeText代碼補(bǔ)完插件
網(wǎng)站URL:http://aaarwkj.com/article12/peijgc.html
成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供定制開發(fā)、靜態(tài)網(wǎng)站、網(wǎng)站建設(shè)、App開發(fā)、微信小程序、云服務(wù)器
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請盡快告知,我們將會在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時(shí)需注明來源: 創(chuàng)新互聯(lián)