Primary
os.symlink() ⚬｜Documentation｜1st｜20251125122710-00-⌔
os — Miscellaneous operating system interfaces — Python 3.14.0 documentation#os.symlink
os.symlink(src, dst, target_is_directory=False, ﹡, dir_fd=None)Create a symbolic link pointing to src named dst.
The src parameter refers to the target of the link (the file or directory being linked to), and dst is the name of the link being created.
On Windows, a symlink represents either a file or a directory, and does not morph to the target dynamically. If the target is present, the type of the symlink will be created to match. Otherwise, the symlink will be created as a directory if target_is_directory is
Trueor a file symlink (the default) otherwise. On non-Windows platforms, target_is_directory is ignored.This function can support paths relative to directory descriptors.
Note: On newer versions of Windows 10, unprivileged accounts can create symlinks if Developer Mode is enabled. When Developer Mode is not available/enabled, the SeCreateSymbolicLinkPrivilege privilege is required, or the process must be run as an administrator.
OSErroris raised when the function is called by an unprivileged user.Raises an auditing event
os.symlinkwith argumentssrc,dst,dir_fd.Availability: Unix, Windows.
The function is limited on WASI, see WebAssembly platforms for more information.
Changed in version 3.2: Added support for Windows 6.0 (Vista) symbolic links.
Changed in version 3.3: Added the dir_fd parameter, and now allow target_is_directory on non-Windows platforms.
Changed in version 3.6: Accepts a path-like object for src and dst.
Changed in version 3.8: Added support for unelevated symlinks on Windows with Developer Mode.
Printed 2026-06-28.
(echo:: @ ᯤ)
Link to original
Secondary
• • •