Issue 33695: Have shutil.copytree(), copy() and copystat() use cached scandir() stat()s (original) (raw)

Created on 2018-05-30 12:22 by giampaolo.rodola, last changed 2022-04-11 14:59 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
bench.py giampaolo.rodola,2018-05-30 12:22
bpo-33695.patch giampaolo.rodola,2018-05-30 12:23 review
Pull Requests
URL Status Linked Edit
PR 7874 merged giampaolo.rodola,2018-06-23 10:34
PR 11425 closed xxxxxxx,2019-02-23 15:13
PR 11997 merged giampaolo.rodola,2019-02-23 17:14
PR 17098 merged kinow,2019-11-09 13:25
Messages (13)
msg318175 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2018-05-30 12:22
Patch in attachment makes shutil.copytree() use os.scandir() and (differently from [#33414](issue33414 "[closed] Make shutil.copytree use os.scandir to take advantage of cached is_(dir|file symlink)")) DirEntry instances are passed around so that cached stat()s are used also from within copy2() and copystat() functions. The number of times the filesystem gets accessed via os.stat() is therefore reduced quite consistently. A similar improvement can be done for rmtree() (but that's for another ticket). Patch and benchmark script are in attachment. Linux (+13.5% speedup) ====================== --- without patch: ./python bench.py Priming the system's cache... 7956 files and dirs, repeat 1/3... min = 0.551s 7956 files and dirs, repeat 2/3... min = 0.548s 7956 files and dirs, repeat 3/3... min = 0.548s best result = 0.548s --- with patch: $ ./python bench.py Priming the system's cache... 7956 files and dirs, repeat 1/3... min = 0.481s 7956 files and dirs, repeat 2/3... min = 0.479s 7956 files and dirs, repeat 3/3... min = 0.474s best result = 0.474s Windows (+17% speedup) ====================== --- without patch: ./python bench.py Priming the system's cache... 7956 files and dirs, repeat 1/3... min = 9.015s 7956 files and dirs, repeat 2/3... min = 8.747s 7956 files and dirs, repeat 3/3... min = 8.614s best result = 8.614s --- with patch: $ ./python bench.py Priming the system's cache... 7956 files and dirs, repeat 1/3... min = 7.827s 7956 files and dirs, repeat 2/3... min = 7.369s 7956 files and dirs, repeat 3/3... min = 7.153s best result = 7.153s Windows SMB share (+30%) ======================== --- without patch: C:\Users\user\Desktop\cpython>PCbuild\win32\python.exe bench.py Priming the system's cache... 7956 files and dirs, repeat 1/3... min = 46.853s 7956 files and dirs, repeat 2/3... min = 46.330s 7956 files and dirs, repeat 3/3... min = 44.720s best result = 44.720s --- with patch: C:\Users\user\Desktop\cpython>PCbuild\win32\python.exe bench.py Priming the system's cache... 7956 files and dirs, repeat 1/3... min = 31.729s 7956 files and dirs, repeat 2/3... min = 30.936s 7956 files and dirs, repeat 3/3... min = 30.936s best result = 30.936s Number of stat() syscalls (-38%) ================================ --- without patch: $ strace ./python bench.py 2>&1 grep "stat(" wc -l 324808 --- with patch: $ strace ./python bench.py 2>&1 grep "stat("
msg320303 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2018-06-23 10:53
PR at: https://github.com/python/cpython/pull/7874. I re-ran benchmarks since shutil code changed after #33695. Linux went from +13.5% to 8.8% and Windows went from +17% to 20.7%. In the PR I explicitly avoided using a context manager around os.scandir() for now so that patch it's easier to review (will add it before pushing). Linux (+8.8%) ============= without patch: $ ./python bench-copytree.py Priming the system's cache... 7956 files and dirs, repeat 1/3... min = 0.604s 7956 files and dirs, repeat 2/3... min = 0.603s 7956 files and dirs, repeat 3/3... min = 0.601s with patch: $ ./python bench-copytree.py Priming the system's cache... 7956 files and dirs, repeat 1/3... min = 0.557s 7956 files and dirs, repeat 2/3... min = 0.548s 7956 files and dirs, repeat 3/3... min = 0.548s best result = 0.548s Windows (+20.7%) ================ without patch: C:\Users\user\Desktop>cpython\PCbuild\win32\python.exe cpython\bench-copytree.py Priming the system's cache... 7956 files and dirs, repeat 1/3... min = 8.275s 7956 files and dirs, repeat 2/3... min = 8.018s 7956 files and dirs, repeat 3/3... min = 7.978s best result = 7.978s With patch: C:\Users\user\Desktop>cpython\PCbuild\win32\python.exe cpython\bench-copytree.py Priming the system's cache... 7956 files and dirs, repeat 1/3... min = 6.609s 7956 files and dirs, repeat 2/3... min = 6.609s 7956 files and dirs, repeat 3/3... min = 6.609s best result = 6.609s
msg320304 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2018-06-23 11:08
> I re-ran benchmarks since shutil code changed after #33695. Sorry, I meant #33671.
msg321852 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2018-07-17 21:45
Unless somebody has complaints I think I'm gonna merge this soon.
msg322872 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2018-08-01 16:20
I'm not convinced that this change should be merged. The benefit is small, and 1) it is only for an artificial set of tiny files, 2) the benchmarking ignores the real IO, it measures the work with a cache. When copy real files (/usr/include or Lib/) with dropped caches the difference is insignificant. On other hand, this optimization makes the code more complex. It can make the case with specifying the ignore argument slower.
msg322873 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2018-08-01 16:24
For dropping disc caches on Linux run with open('/proc/sys/vm/drop_caches', 'ab') as f: f.write(b'3\n') before every test.
msg322901 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2018-08-02 00:16
I agree the provided benchmark on Linux should be more refined. And I'm not sure if "echo 3 | sudo tee /proc/sys/vm/drop_caches" before running it is enough honestly. The main point here is the reduction of stat() syscalls (-38%) and that can make a considerable difference, especially with network filesystems. That's basically the reason why scandir() was introduced in the first place and used in os.walk() glob.glob() and shutil.rmtree(), so I'm not sure why we should use a different rationale for shutil.copytree().
msg322912 - (view) Author: Serhiy Storchaka (serhiy.storchaka) * (Python committer) Date: 2018-08-02 03:52
os.walk() and glob.glob() used *only* stat(), opendir() and readdir() syscalls (and stat() syscalls dominated). The effect of reducing the number of the stat() syscalls is significant. shutil.rmtree() uses also the unlink() syscall. Since it is usually cheap (but see ), the benefit still is good, but not such large. Actually I had concerns about using scandir() in shutil.rmtree(). shutil.copytree() needs to open, read, and write files. This is not so cheap, and the benefit of reducing the number of the stat() syscalls is hardly noticed in real cases. shutil.copytree() was not converted to using scandir() intentionally.
msg322933 - (view) Author: STINNER Victor (vstinner) * (Python committer) Date: 2018-08-02 09:24
When I worked on the os.scandir() implementation, I recall that an interesting test was NFS. Depending on the configuration, stat() in a network filesystem can be between very slow and slow.
msg322975 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2018-08-02 16:10
Yes, file copy (open() + read() + write()) is of course more expensive than just "reading" a tree (os.walk(), glob()) or deleting it (rmtree()) and the "pure file copy" time adds up to the benchmark. And indeed it's not an coincidence that #33671 (which replaced read() + write() with sendfile()) shaved off a 5% gain from the benchmark I posted initially for Linux. Still, in a 8k small-files-tree scenario we're seeing ~9% gain on Linux, 20% on Windows and 30% on a SMB share on localhost vs. VirtualBox. I do not consider this a "hardly noticeable gain" as you imply: it is noticeable, exponential and measurable, even with cache being involved (as it is). Note that the number of stat() syscalls per file is being reduced from 6 to 1 (or more if follow_symlinks=False), and that is the real gist here. That *does* make a difference on a regular Windows fs and makes a huge difference with network filesystems in general, as a simple stat() call implies access to the network, not the disk.
msg322984 - (view) Author: Yury Selivanov (yselivanov) * (Python committer) Date: 2018-08-02 18:02
> Depending on the configuration, stat() in a network filesystem can be between very slow and slow. +1. I also quickly glanced over the patch and I think it looks like a clear win.
msg328267 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2018-10-22 18:09
@Serhiy: I would like to proceed with this. Do you have further comments? Do you prefer to bring this up on python-dev for further discussion?
msg329732 - (view) Author: Giampaolo Rodola' (giampaolo.rodola) * (Python committer) Date: 2018-11-12 14:18
New changeset 19c46a4c96553b2a8390bf8a0e138f2b23e28ed6 by Giampaolo Rodola in branch 'master': bpo-33695 shutil.copytree() + os.scandir() cache (#7874) https://github.com/python/cpython/commit/19c46a4c96553b2a8390bf8a0e138f2b23e28ed6
History
Date User Action Args
2022-04-11 14:59:01 admin set github: 77876
2019-11-09 13:25:26 kinow set pull_requests: + <pull%5Frequest16605>
2019-02-23 17:14:29 giampaolo.rodola set pull_requests: + <pull%5Frequest12025>
2019-02-23 15:13:39 xxxxxxx set pull_requests: + <pull%5Frequest12022>
2018-11-12 14:19:18 giampaolo.rodola set status: open -> closedassignee: giampaolo.rodolaresolution: fixedstage: patch review -> resolved
2018-11-12 14🔞24 giampaolo.rodola set messages: +
2018-10-22 18:09:26 giampaolo.rodola set messages: +
2018-08-02 18:02:38 yselivanov set messages: +
2018-08-02 16:10:19 giampaolo.rodola set messages: +
2018-08-02 09:24:17 vstinner set messages: +
2018-08-02 03:52:46 serhiy.storchaka set messages: +
2018-08-02 00:16:31 giampaolo.rodola set messages: +
2018-08-01 16:24:07 serhiy.storchaka set messages: +
2018-08-01 16:20:44 serhiy.storchaka set messages: +
2018-07-17 21:45:24 giampaolo.rodola set messages: +
2018-06-23 11:08:10 giampaolo.rodola set messages: +
2018-06-23 10:53:20 giampaolo.rodola set messages: +
2018-06-23 10:34:07 giampaolo.rodola set pull_requests: + <pull%5Frequest7481>
2018-05-30 12:41:32 giampaolo.rodola set nosy: + brett.cannon, ncoghlan, vstinner, benjamin.peterson, tarek, stutzbach, benhoyt, serhiy.storchaka, yselivanov
2018-05-30 12:23:33 giampaolo.rodola set files: + bpo-33695.patchkeywords: + patch
2018-05-30 12:22:35 giampaolo.rodola create