平時習慣了雜亂無章地編寫程式碼,而最後的程式碼勘定,卻依賴於PyCharm自帶的格式化工具,以及其自帶的提示功能來規範程式碼。而pycharm裡的格式化工具,不支援對多檔案進行程式碼批量格式化,曾經嘗試些解決方案,結果無功而返,不了了之。今天看到這個工具,終於有望了。
# 本地小試
cd /home/kylin/program
git clone https://github.com/google/yapf.git
PYTHONPATH=/home/kylin/program/yapf/ python /home/kylin/program/yapf/yapf -h
......
以下轉載於網路對原文的翻譯:http://geek.csdn.net/news/detail/29735
介紹
目前用於Python的格式化程式(如autopep8和pep8ify)都用於刪除程式碼中的lint錯誤。這有很明顯的侷限性。
YAPF採用了不同的方法,基於Daniel Jasper開發的“'clang-format”。從本質上來說,該演算法取走程式碼並重新排版,以符合樣式指南的最佳格式,即便原始程式碼沒有違反樣式指南。這個想法也是類似於Go程式語言的gofmt工具。
其最終目標是讓YAPE所產生的程式碼可以與程式設計師所寫的程式碼一樣好(前提是程式設計師遵循樣式指南),它取代了一些維護程式碼的苦差。
安裝
如果你打算使用YAPF作為一個命令列工具,而不是一個庫,那麼安裝是沒有必要的。通過Python直譯器,YAPF可以作為一個目錄執行。如果你克隆/解壓YAPF到DIR,可以這麼執行:
$ PYTHONPATH=DIR python DIR/yapf [options] ...
Python版本
YAPF支援Python2.7和3.4+。
用法
設定:
格式樣式
使用YPF的格式樣式是可以配置的,並且有許多“knobs”可用於調整YAPF是如何做格式的。(檢視style.py模組)
為了控制樣式,執行帶有--style的YAPF。它接受一個預定義的樣式(例如pep8或google)——一個通往配置檔案(能指定所需樣式或一個鍵/值對的字典)的途徑。
配置檔案是一個簡單的鍵=值對的列表(區分大小寫),擁有一個【style】,例如:
當然也可以通過字典在命令列上做出同樣的事情,例如:
--style='{basedonstyle: google, indent_width: 4}'
這將用google作為基礎樣式,並修改成擁有4個空格縮排。
案例
通過YAPF,可以將下面這段程式碼:
重新格式化成:
常見問題
為什麼YAPF破壞了我很棒的格式?
對於一些程式碼,它不會比手動格式好,特別是大的資料文字,在YAPF下會變得更糟糕。引起這些的原因是多樣的,但是從本質上來說,YAPF只是一個幫助開發的簡單工具,它將事物與樣式指南保持一致,但這並不等於可讀性。
為減輕這種情況,你需要表明YAPF重新格式化時需要忽視的區域:
你也可以禁用格式單一的字面,例如:
為什麼不改善現有的工具?
現有的工具要考慮到不同的目標,並需要大量的修改轉換以便使用clang-format演算法。我們希望使用clang-format重組演算法。
我可以在程式中使用YAPF嗎?
答案是肯定的!YAPF被設計用於作為一個庫以及一個命令列工具來使用。這意味著使用YAPF時,一個工具或IDE外掛是免費的。
注:更多詳細內容可在GitHub上獲取,點此進入。