From: Andrés Delfino Date: Sun, 24 Jun 2018 02:23:50 +0000 (-0300) Subject: [master] bpo-33885: Replace "hook function" with "callable" (GH-7765) (#7886) X-Git-Tag: v3.8.0a1~1502 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=0ba9a0b7d19da8b4bd3c13b358d3fd2a5ad16f09;p=python [master] bpo-33885: Replace "hook function" with "callable" (GH-7765) (#7886) (cherry picked from commit c45cb479074b5d25f0d382d3109f527520a9f03c) Co-authored-by: Andrés Delfino --- diff --git a/Doc/library/urllib.request.rst b/Doc/library/urllib.request.rst index b7116fabcd..0a9d9dae21 100644 --- a/Doc/library/urllib.request.rst +++ b/Doc/library/urllib.request.rst @@ -1339,9 +1339,9 @@ some point in the future. The second argument, if present, specifies the file location to copy to (if absent, the location will be a tempfile with a generated name). The third - argument, if present, is a hook function that will be called once on + argument, if present, is a callable that will be called once on establishment of the network connection and once after each block read - thereafter. The hook will be passed three arguments; a count of blocks + thereafter. The callable will be passed three arguments; a count of blocks transferred so far, a block size in bytes, and the total size of the file. The third argument may be ``-1`` on older FTP servers which do not return a file size in response to a retrieval request.