# `netrc` --- netrc 檔案處理

原始碼：Lib/netrc.py

`netrc` 類別能夠剖析 (parse) 並封裝 (encapsulate) netrc 檔案格式，以供 Unix ftp 程式和其他 FTP 用戶端使用。

class netrc.netrc([file])

  `netrc` 實例或其子類別實例能夠封裝來自 netrc 檔案的資料。可用初始化引數（如有給定）指定要剖析的檔案，如果未給定引數，則將讀取（由 `os.path.expanduser()` 指定的）使用者主目錄中的 `.netrc` 檔案，否則將引發 `FileNotFoundError` 例外。剖析錯誤會引發 `NetrcParseError`，其帶有包括檔案名稱、列號和終止 token 的診斷資訊。如果在 POSIX 系統上未指定引數，且若檔案所有權或權限不安全（擁有者與運行該行程的使用者不同，或者可供任何其他使用者讀取或寫入），存有密碼的 `.netrc` 檔案將會引發 `NetrcParseError`。這實作了與 ftp 和其他使用 `.netrc` 程式等效的安全行為。

  在 3.4 版的變更: 新增了 POSIX 權限檢查。

  在 3.7 版的變更: 當未傳遞 file 引數時，`os.path.expanduser()` 可用於查找 `.netrc` 檔案的位置。

  在 3.10 版的變更: `netrc` 在使用特定語言環境編碼前會先嘗試 UTF-8 編碼。netrc 檔案中的條目就不再需要包含所有 token，缺少的 token 值被預設為空字串。現在所有 token 及其值都可以包含任意字元，例如空格和非 ASCII 字元。如果登入名稱為匿名，就不會觸發安全檢查。

exception netrc.NetrcParseError

  當原始文本中遇到語法錯誤時，`netrc` 類別會引發例外。此例外的實例提供了三個有趣的屬性：

  msg

    錯誤的文字解釋。

  filename

    原始檔案的名稱。

  lineno

    發現錯誤的列號。

## netrc 物件

`netrc` 實例具有以下方法：

netrc.authenticators(host)

  回傳 host 身份驗證器的三元素 tuple `(login, account, password)`。如果 netrc 檔案不包含給定主機的條目，則回傳與 'default' 條目關聯的 tuple。如果並無匹配主機且預設條目也不可用則回傳 `None`。

netrc.__repr__()

  將類別資料傾印 (dump) 為 netrc 檔案格式的字串。（這會將註解移除，並可能會對條目重新排序。）

`netrc` 的實例具有公開實例變數：

netrc.hosts

  將主機名稱對映到 `(login, account, password)` tuple 的字典。'default' 條目（如存在）表示為該名稱對應到的偽主機 (pseudo-host)。

netrc.macros

  巨集 (macro) 名稱與字串 list（串列）的對映字典。