[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Path-like objects in the standard library

On 8/24/2018 5:28 AM, Paul Moore wrote:
> On Fri, 24 Aug 2018 at 09:57, Torsten Bronger
> <bronger at physik.rwth-aachen.de> wrote:
>> Hall?chen!
>> Path-like objects are accepted by all path-processing functions in
>> the standard library since Python 3.6.  Unfortunately, this is not
>> made explicit everywhere.  In particular, if I pass a Path in the
>> first argument of subprocess.run, do I use an implementation detail
>> of CPython?  Because on
>> https://docs.python.org/3.6/library/subprocess.html, only for the
>> cwd argument the acceptance of Paths is stated explicitly.
>> The same goes for all functions in the shutil module.
>> https://docs.python.org/3.6/library/shutil.html does not mention the
>> path-like protocol anywhere, but the CPython modules seem to accept
>> them anyway.
> I would imagine that doc fixes would be gratefully accepted. Or if
> they are rejected, that rejection would be confirmation that the
> support is intended as an implementation detail (and a fix to the
> documentation to explicitly state that would be reasonable).
> Personally, I'd expect that the intention is that you can rely on it.
> Paul

Terry Jan Reedy