वीआईएम में पायथन स्रोत कोड में लंबे डॉकस्ट्रिंग को कैसे फोल्ड करें?

Question

क्या किसी को किसी विधि, या शायद प्लग-इन के बारे में पता है, जो स्वचालित रूप से पाइथन में लंबे डॉकस्ट्रिंग को फोल्ड करेगा? मेरे पास कोड में डॉकस्ट्रिंग हैं जो कई पृष्ठों को फैलाती है, इसलिए पेजिंग उनके माध्यम से पेजिंग रखने में परेशानी होती है। दूसरा मुश्किल हिस्सा यह है कि डॉकस्ट्रिंग में एम्बेडेड पायथन परीक्षण कोड है, जिससे उन्हें को पार्सिंग करना मुश्किल हो सकता है। ध्यान दें कि मुझे केवल संपूर्ण डॉकस्ट्रिंग को स्वचालित रूप से फोल्ड करने की आवश्यकता है, चाहे इसमें क्या हो।

अग्रिम धन्यवाद।

Answer 1

यह एक गंदे हैक का थोड़ा सा है, लेकिन आप पाइथन सिंटैक्स फ़ाइल (:sp $VIMRUNTIME/syntax/python.vim) के माध्यम से जा सकते हैं और तीन वाक्यविन्यास क्षेत्रों को ट्रिपल- उद्धृत स्ट्रिंग्स (''' और """ के लिए खोजें) और उन बयानों के अंत में fold कीवर्ड जोड़ें। फिर केवल Python फ़ाइलों के लिए foldmethod=syntax सेट करें और टिप्पणियों को फोल्ड किया जाना चाहिए।

Answer 2

मुझे प्लगइन या स्वचालन के बारे में निश्चित नहीं है, लेकिन यदि आप zf/ टाइप करते हैं तो आप कुछ खोज सकते हैं और यह इसके अगले उदाहरण तक पहुंच जाएगा। निम्नलिखित (कर्सर जहां [] है) की तरह एक दस्तावेज़ में तो:

def foo(): 
    """[] 
    Some long docstring 
    that takes up many 
    lines 
    """ 
    pass 

अद्यतन खोज स्ट्रिंग के लिए EDIT2 पर देखो पहले!

आप कमांड zf/"""[ENTER] उपयोग करते हैं, यह वर्तमान पंक्ति (docstring की शुरुआत) """ की अगली आवृत्ति जो docstring के अंत होना चाहिए करने के लिए से सब कुछ गुना चाहिए।

मुझे पता है कि यह स्वचालन नहीं है, लेकिन शायद यह अंतरिम में मदद करेगा, या इसे स्वचालित करने के लिए सही रास्ते का नेतृत्व करेगा। एक बेहतर खोज फ़ंक्शन के लिए संपादन 2 देखें, हालांकि मुझे अभी भी पता नहीं है कि स्वचालित कैसे करें।

उम्मीद है कि इससे मदद मिलती है।

संपादित: एक परिणाम में, आप, /"""\_.\{-}""" के साथ किसी भी docstring के लिए खोज है, हालांकि यह भी docstring भीतर कोड प्राप्त होगा कर सकते हैं। डॉकस्ट्रिंग के बाद फ़ंक्शन परिभाषा की खोज करने के लिए, आप /def\_.\{-}"""\_.\{-}""" का उपयोग कर सकते हैं, हालांकि यह डॉकस्ट्रिंग के अंदर एक डीफ़ पर टूट जाता है।

EDIT2: /def.\{-}):\_s*"""\_.\{-}""" जो किसी भी समारोह एक docstring के बाद खोजना चाहिए: वास्तव में, कुछ और regexs के साथ खेल मेरे लिए इस का नेतृत्व किया। यह def के बाद किसी भी पात्र, ): के बाद """ के बाद """ की तुलना में किसी भी संख्या के बाद लाइनों की खोज करता है, लेकिन हमेशा यह सुनिश्चित करता है कि दूसरा ट्रिपल कोट पहले के बाद तुरंत होता है।

Answer 3

अपने .vimrc में जोड़ें:

" folding 
set foldmethod=indent 

हर खरोज है, जो, अजगर में, docstrings करने के लिए अनुवाद में हो जाएगा ताकि ऑटो गुना। यह बहुत बहुत अच्छा काम करता है। कोशिश करो। उपर्युक्त उत्तर सही है, लेकिन कीस्ट्रोक का एक गुच्छा (ब्लाह!)

Answer 4

आप इसे :set foldmethod=marker foldmarker=""",""" के साथ कर सकते हैं, मुझे लगता है। मैंने इसका परीक्षण नहीं किया है, लेकिन यह चाल चलाना चाहिए। Foldmarker के लिए तर्क शुरू और अंत मार्कर हैं।

Answer 5

मैंने कई साल पहले एक विस्क्रिप्ट प्लगइन लिखा था, लेकिन इसे प्रकाशित करने के लिए कभी नहीं मिला। मैंने इसे gist के रूप में रखा है, लेकिन नीचे दिए गए स्रोत को भी चिपकाया है। मैंने सब्लिमे टेक्स्ट here के लिए अपनी कार्यक्षमता भी दोहराई है।

" 
" Fold multi-line Python comments into one line. 
" 
" Also maps the "-" key to toggle expansion and <C-f> to toggle all folding. 
" 
setlocal foldmethod=syntax 
setlocal foldtext=FoldText() 
setlocal fillchars= 

map <buffer> - za 
map <buffer> <C-f> :call ToggleFold()<CR> 

let b:folded = 1 

hi Folded  gui=bold cterm=bold guifg=cyan ctermfg=cyan guibg=NONE ctermbg=NONE 

function! ToggleFold() 
    if b:folded == 0 
    exec "normal! zM" 
    let b:folded = 1 
    else 
    exec "normal! zR" 
    let b:folded = 0 
    endif 
endfunction 

function! s:Strip(string) 
    return substitute(a:string, '^[[:space:][:return:][:cntrl:]]\+\|[[:space:][:return:][:cntrl:]]\+$', '', '') 
endfunction 

" Extract the first line of a multi-line comment to use as the fold snippet 
function! FoldText() 
    let l:snippet = getline(v:foldstart) 
    if len(s:Strip(l:snippet)) == 3 
    let l:snippet = strpart(l:snippet, 1) . s:Strip(getline(v:foldstart + 1)) 
    endif 
    return '+' . l:snippet . ' ...' 
endfunction 

Answer 6

मेरा समाधान SimpylFold का उपयोग करना शामिल है। Vundle का उपयोग कर इसे स्थापित करने के बाद, मैं अपने vimrc फ़ाइल में इस डाल:

autocmd FileType python setlocal foldlevel=2 

कौन सा सब docstrings डिफ़ॉल्ट रूप से मुड़ा हुआ है जब आप एक अजगर फ़ाइल है, जो सुपर भयानक है खोलने बनाता है।