voussoir/voussoirkit
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Replace duplicated docstring remarks with simple hints.

Browse source
This commit is contained in:
voussoir 2021-01-18 01:34:27 -08:00
parent 826c2f5e5d
commit aa68744107
No known key found for this signature in database
GPG key ID: 5F7554F8C26DACCB
1 changed files with 9 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

23
voussoirkit/spinal.py
View file

@ -121,9 +121,7 @@ def copy_dir(
destination_new_root. destination_new_root.
bytes_per_second: bytes_per_second:
Restrict file copying to this many bytes per second. Can be an integer Passed into each `copy_file` as `bytes_per_second`.
or an existing Ratelimiter object.
The BYTE, KIBIBYTE, etc constants from module 'bytestring' may help.
callback_directory_progress: callback_directory_progress:
This function will be called after each file copy with three arguments: This function will be called after each file copy with three arguments:
@ -136,12 +134,10 @@ def copy_dir(
Passed directly into `walk_generator`. Passed directly into `walk_generator`.
callback_file_progress: callback_file_progress:
Will be passed into each individual `copy_file` operation as the Passed into each `copy_file` as `callback_progress`.
`callback_progress` for that file.
callback_permission_denied: callback_permission_denied:
Will be passed into each individual `copy_file` operation as the Passed into each `copy_file` as `callback_permission_denied`.
`callback_permission_denied` for that file.
callback_pre_directory: callback_pre_directory:
This function will be called before each directory and subdirectory This function will be called before each directory and subdirectory
@ -154,8 +150,7 @@ def copy_dir(
the current file and then stop. the current file and then stop.
callback_pre_file: callback_pre_file:
Will be passed into each individual `copy_file` operation as the Passed into each `copy_file` as `callback_pre_copy`.
`callback_pre_copy` for that file.
destination_new_root: destination_new_root:
Determine the destination path by calling Determine the destination path by calling
@ -178,8 +173,7 @@ def copy_dir(
usage low. usage low.
overwrite_old: overwrite_old:
If True, overwrite the destination file if the source file Passed into each `copy_file` as `overwrite_old`.
has a more recent "last modified" timestamp.
precalcsize: precalcsize:
If True, calculate the size of source before beginning the copy. If True, calculate the size of source before beginning the copy.
@ -352,9 +346,9 @@ def copy_file(
Thus, this path acts as a root and the rest of the path is matched. Thus, this path acts as a root and the rest of the path is matched.
bytes_per_second: bytes_per_second:
Restrict file copying to this many bytes per second. Can be an integer Restrict file copying to this many bytes per second. Can be an integer,
or an existing Ratelimiter object. an existing Ratelimiter object, or a string parseable by bytestring.
The provided BYTE, KIBIBYTE, etc constants may help. The bytestring BYTE, KIBIBYTE, etc constants may help.
callback_permission_denied: callback_permission_denied:
If provided, this function will be called when a source file denies If provided, this function will be called when a source file denies
@ -385,6 +379,7 @@ def copy_file(
overwrite_old: overwrite_old:
If True, overwrite the destination file if the source file If True, overwrite the destination file if the source file
has a more recent "last modified" timestamp. has a more recent "last modified" timestamp.
If False, existing files will be skipped no matter what.
validate_hash: validate_hash:
If True, verify the file hash of the resulting file, using the If True, verify the file hash of the resulting file, using the