[docs] [issue13498] os.makedirs exist_ok documentation is incorrect, as is some of the behavior
Hynek Schlawack
report at bugs.python.org
Sun Oct 7 11:27:52 CEST 2012
Hynek Schlawack added the comment:
Let's get this rolling again. First let's fix the docs for 3.2+ first. My current suggestion would be the following:
~~~
.. function:: makedirs(path, mode=0o777, exist_ok=False)
.. index::
single: directory; creating
single: UNC paths; and os.makedirs()
Recursive directory creation function. Like :func:`mkdir`, but makes all
intermediate-level directories needed to contain the leaf directory.
The default *mode* is ``0o777`` (octal). On some systems, *mode* is
ignored. Where it is used, the current umask value is first masked out.
If *exists_ok* is ``False`` (the default), an :exc:`OSError` is raised if
the target directory already exists. If *exists_ok* is ``True`` an
:exc:`OSError` is still raised if the umask-masked *mode* is different from
the existing mode, on systems where the mode is used. :exc:`OSError` will
also be raised if the directory creation fails.
.. note::
:func:`makedirs` will become confused if the path elements to create
include :data:`pardir` (eg. ".." on UNIX systems).
This function handles UNC paths correctly.
.. versionadded:: 3.2
The *exist_ok* parameter.
~~~
Opinions?
----------
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue13498>
_______________________________________
More information about the docs
mailing list