Path.mkdir(parents, exist_ok) in Python

Buy Me a Coffee☕

Path.mkdir() can create zero or more directories as shown below:

*Memos:

• There is the 1st argument for Path() (Required-Type:str, bytes or os.PathLike). *Its argument name doesn't exist.
• The 1st argument is mode for mkdir() (Optional-Default:0o777-Type:int).
• The 2nd argument is parents for mkdir() (Optional-Default:False-Type:bool): *Memos:
  • If it's False, the path with a target directory and one or more non-existent parent directories cannot be created, getting FileNotFoundError.
  • If it's True, the path with a target directory and one or more non-existent parent directories can be created, not getting FileNotFoundError.
  • Basically, True is set to it.
• The 3rd argument is exist_ok for mkdir() (Optional-Default:False-Type:bool): *Memos:
  • If it's False, FileExistsError is raised for an existent path.
  • If it's True, FileExistsError isn't raised for an existent path.
  • Basically, True is set to it.

# Parent directories # ↓↓↓↓ ↓↓↓↓↓↓ p = Path('dir3/dir3_1/dir3_1_1') # ↑↑↑↑↑↑↑↑ # A target directory 

1. Creating dir1 is successful:

from pathlib import Path p = Path('dir1') p.mkdir() # Or # p.mkdir(mode=0o777, parents=False, exist_ok=False)  # my_project # └-dir1 <- Here 

2. Recreateing dir1 is failed and gets FileExistsError:

from pathlib import Path p = Path('dir1') p.mkdir() # FileExistsError: [Errno 17] File exists: 'dir1'  # my_project # └-dir1 

3. Recreating dir1 with exist_ok=True is failed but doesn't get FileExistsError:

from pathlib import Path p = Path('dir1') p.mkdir(exist_ok=True) # my_project # └-dir1 

4. Creating dir1_1 in dir1 is successful:

from pathlib import Path p = Path('dir1/dir1_1') p.mkdir() # my_project # └-dir1 # └-dir1_1 <- Here 

5. Creating dir2/dir2_1 is failed and gets FileNotFoundError:

from pathlib import Path p = Path('dir2/dir2_1') p.mkdir() # FileNotFoundError: [Errno 2] No such file or directory: 'dir2/dir2_1'  # my_project # └-dir1 # └-dir1_1 

6. Creating dir2/dir2_1 with parents=True is successful:

from pathlib import Path p = Path('dir2/dir2_1') p.mkdir(parents=True) # my_project # |-dir1 # | └-dir1_1 # └-dir2 <- Here # └-dir2_1 <- Here 

7. Creating dir3/dir3_1/dir3_1_1 with parents=True and exist_ok=True is successful:

from pathlib import Path p = Path('dir3/dir3_1/dir3_1_1') p.mkdir(parents=True, exist_ok=True) # my_project # |-dir1 # | └-dir1_1 # |-dir2 # | └-dir2_1 # └-dir3 <- Here # └-dir3_1 <- Here # └-dir3_1_1 <- Here 

8. Recreating dir3/dir3_1/dir3_1_1 with parents=True and exist_ok=True is failed but doesn't get FileExistsError:

from pathlib import Path p = Path('dir3/dir3_1/dir3_1_1') p.mkdir(parents=True, exist_ok=True) # my_project # |-dir1 # | └-dir1_1 # |-dir2 # | └-dir2_1 # └-dir3 # └-dir3_1 # └-dir3_1_1