Asynchronous shutil module.
Project Links
Meta
Author: Kumar Aditya
Requires Python: >=3.8
Classifiers
Development Status
- 5 - Production/Stable
Framework
- AsyncIO
Programming Language
- Python
- Python :: 3
- Python :: 3.9
- Python :: 3.10
- Python :: 3.11
- Python :: 3.12
- Python :: 3.13
- Python :: 3.14
- Python :: 3 :: Only
- Python :: Implementation :: CPython
- Python :: Implementation :: PyPy
Operating System
- OS Independent
License
- OSI Approved :: BSD License
aioshutil: Asynchronous shutil module.
Introduction
aioshutil is a Python library which provides asynchronous version of function of shutil module. shutil module is blocking and using it in asyncio applications will block the event loop and slow down the application, aioshutil provides asynchronous friendly versions of the functions of the shutil module as it performs blocking io in a thread pool.
Installation
$ pip install aioshutil
Usage
The API of aioshutil module is same as shutil module except that it is asynchronous.
from aioshutil import rmtree
await rmtree("/tmp")
aioshutil provides the following functions:
copyfileobjcopyfilecopymodecopystatcopycopy2copytreemovermtreemake_archiveget_archive_formatsregister_archive_formatunregister_archive_formatget_unpack_formatsregister_unpack_formatunregister_unpack_formatunpack_archiveignore_patternschownwhichget_terminal_size
aioshutil provides the following exceptions for consistency with shutil module:
ErrorSpecialFileErrorSameFileError
1.7a1
Aug 23, 2026
1.6
Oct 21, 2025
1.6a1
Aug 15, 2025
1.5
Jul 20, 2024
1.4
May 27, 2024
1.3
Mar 14, 2023
1.2
Oct 27, 2022
1.2a1
Oct 27, 2022
1.1
May 14, 2021
1.0
Apr 05, 2021
0.0.1a1
Apr 05, 2021
0.0.1a0
Apr 05, 2021
Wheel compatibility matrix
Files in release
Extras:
None
Dependencies:
typing-extensions