提高python代碼可讀性利器pycodestyle怎么使用

本篇內容介紹了“提高python代碼可讀性利器pycodestyle怎么使用”的有關知識，在實際案例的操作過程中，不少人都會遇到這樣的困境，接下來就讓小編帶領大家學習一下如何處理這些情況吧！希望大家仔細閱讀，能夠學有所成！

關于PEP-8

pycodestyle 檢查器提供基于 PEP-8 樣式約定的代碼建議。那么 PEP-8 到底是什么呢？

PEP 代表 Python 增強建議，PEP-8 是一個概述編寫 Python 代碼最佳實踐的指南。它的主要目標是通過標準化代碼樣式來提高代碼的整體一致性和可讀性。

目的

快速瀏覽一下PEP-8文檔，就會發現有太多的最佳實踐需要記住。

而且，已經花了這么多精力編寫了這么多行代碼，你當然不希望浪費更多的時間手動檢查腳本的可讀性。

這就是 pycodestyle 自動分析 Python 腳本并指出代碼可以改進的地方。

安裝

pip 是首選的安裝程序，你可以通過在終端中運行以下命令來安裝或升級 pycodestyle：

# Install pycodestyle
pip install pycodestyle
# Upgrade pycodestyle
pip install --upgrade pycodestyle

基本用法

最直接的用法是在 Python 腳本（.py文件）上作為命令在終端中運行pycodestyle。

讓我們使用以下示例腳本（名為 pycodestyle_sample_script.py）進行演示：

# pycodestyle_sample_script.py 
# Import libraries
import numpy as np, pandas as pd
# Take the users input
words = raw_input("Enter some text to translate to pig latin: " )
# Break apart the words into a list
words_list = words.split(' ' )
for word in words_list:
    if len(word) >= 3 : # For this pig latin translation, we only want to translate words greater than 3 characters
        pig_latin = word + "%say" % (word[0])
        pig_latin = pig_latin[ 1: ]
        print(pig_latin )
    else:
        pass

我們通過運行以下簡單命令來實現pycodestyle：

pycodestyle pycodestyle_sample_script.py

輸出指定違反PEP-8樣式約定的代碼位置：

每行中由冒號分隔的一對數字（如3:19）分別表示行號和字符號。

例如，在"）"之前輸出6:64 E202空格意味著在第6行中，第64個字符標記處有一個意外的空格。

你也可以通過分析 statistics 參數來查看錯誤發生的頻率：

pycodestyle --statistics -qq pycodestyle_sample_script.py

在上面的輸出中，我們看到在右括號“）”之前出現了4次意外的空白。

高級用法

我們還可以將 pycodestyle 直接導入到 Python 代碼中，以執行自動化測試。這對于自動測試多個腳本的編碼風格一致性非常有用。

例如，可以編寫以下類來自動檢查是否符合PEP-8約定：

import unittest
import pycodestyle
class TestCodeFormat(unittest.TestCase):
    def test_conformance(self):
        """Test that the scripts conform to PEP-8."""
        style = pycodestyle.StyleGuide(quiet=True)
        result = style.check_files(['file1.py', 'file2.py'])
        self.assertEqual(result.total_errors, 0, "Found style  
        errors")

還可以配置該工具，以便根據我們定義的樣式規則首選項進行測試。例如，我們可以刪除不希望在檢查中檢測到的特定錯誤：

style = pycodestyle.StyleGuide(ignore=['E201', 'E202', 'E501'])

或者，我們可以指示 pycodestyle 一起使用不同的配置文件（包含一組特定的樣式規則）。

import pycodestyle
style = pycodestyle.StyleGuide(config_file='/path/to/tox.ini')

“提高python代碼可讀性利器pycodestyle怎么使用”的內容就介紹到這里了，感謝大家的閱讀。如果想了解更多行業相關的知識可以關注億速云網站，小編將為大家輸出更多高質量的實用文章！