logging.NullHandler和__init__.py在Python請求中的文件位置

Question

我想通過查看流行庫中的代碼來了解關於Python的更多信息。我碰到的第一個圖書館是Kenneth Reitz的python-requests。

我所做的只是git clone <request_repo_url_from_github>，現在我正在檢查代碼。

我正在查看requests/packages中的__init__.py文件。

我有幾個問題想請教：

1. 爲什麼__init__.py內requests/packages，應該有不requests直接下__init__.py文件？或者它是簡單的，因爲這是一個從github直接克隆和卸載的軟件包，它就像這樣？

2. 第二個問題涉及上面的代碼如下。我想知道的是NullHandler究竟做了什麼？我看了一下文檔here，這是什麼意思，有一個'無操作'處理程序。這個Handler將被圖書館開發人員用在哪裏？我的意思是，它有什麼特別之處？

import logging 
try: # Python 2.7+ 
    from logging import NullHandler 
except ImportError: 
    class NullHandler(logging.Handler): 
     def emit(self, record): 
      pass 

Answer 1

1. 有一個__init__.py文件在目錄中打開該目錄爲Python包。它不是而是也將子目錄轉換爲包。如果你看一下源代碼樹，你會看到它看起來像這樣（與非相關的，文件中刪除）

   requests/ 
   | 
   |-- __init__.py 
   |-- packages/ 
       | 
       |-- __init__.py 
       |-- charade/ 
       | | 
       | |-- __init__.py 
       |-- urllib3/ 
        | 
        |-- __init__.py 
   

   這定義了頂級包，requests，也是子包requests.packages，requests.packages.charade和requests.packages.urllib3 。定義這些軟件包對於使它們正確導入是必要的。

   直接回答你問的問題，有是requests/直屬的__init__.py文件。整棵樹中只有一個。

2. NullHandler什麼都不做。它已到位，因此即使用戶沒有配置任何記錄器，也可以無條件地使用對logging庫的調用。基本上，當urllib3嘗試記錄任何內容時，連接到日誌記錄庫的所有記錄器都會被調用。如果有沒有記錄器連接，則日誌記錄庫將發出警告。這些都很糟糕，所以這是一個解決方法，使庫代碼更簡單，而不會強制登錄人員。

Answer 2

從我記得requests，在packages目錄包含其他依賴此筆者決定用requests捆綁而不是添加爲依賴關係沿着鏡子。就我個人而言，我會簡單地使它們依賴，如果有必要引用特定的版本，但我相信他們有捆綁方法的理由。我無論如何，它包含了一個__init__.py這樣的代碼可以把它作爲一個模塊，做這樣的事情：

import requests.packages.urllib3 

如果你看一下requests directory on Github，你會看到確實是有一個__init__.py在該目錄太。如果你想有一個包的層次結構，你需要在每個級別上有這樣一個文件，儘管在最簡單的情況下它可能是一個空文件。

如果你不把__init__.py放在一個目錄中，Python不會將它識別爲一個包 - 這是爲了防止意外地將模塊包含在你不希望的地方。你可以想象任何一種方式，一個目錄可以被命名爲與其他地方的一個包相同的包，並且引起難以置信的混淆，但是由於其中不會有__init__.py，它將被Python忽略。

要回答第二個問題，NullHandler是出於某種原因方便使用日誌處理程序的情況，但實際上並不想執行任何日誌記錄。如果您使用的是執行日誌記錄的庫，但在您的情況下您實際上不想記錄任何內容，則可以使用此功能 - 您安裝NullHandler以將這些日誌記錄消息丟棄，因爲它比輕鬆（並且更好的練習）要比更改他們的庫以去除日誌代碼。

在這個例子中，我想你可以添加一個替代日誌記錄，並簡單地設置日誌記錄級別，以便實際上不生成消息，但是使用NullHandler代替它可能更容易。