You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
61 lines
2.2 KiB
61 lines
2.2 KiB
The `old pathlib <https://bitbucket.org/pitrou/pathlib>`_
|
|
module on bitbucket is in bugfix-only mode.
|
|
The goal of pathlib2 is to provide a backport of
|
|
`standard pathlib <http://docs.python.org/dev/library/pathlib.html>`_
|
|
module which tracks the standard library module,
|
|
so all the newest features of the standard pathlib can be
|
|
used also on older Python versions.
|
|
|
|
Download
|
|
--------
|
|
|
|
Standalone releases are available on PyPI:
|
|
http://pypi.python.org/pypi/pathlib2/
|
|
|
|
Development
|
|
-----------
|
|
|
|
The main development takes place in the Python standard library: see
|
|
the `Python developer's guide <http://docs.python.org/devguide/>`_.
|
|
In particular, new features should be submitted to the
|
|
`Python bug tracker <http://bugs.python.org/>`_.
|
|
|
|
Issues that occur in this backport, but that do not occur not in the
|
|
standard Python pathlib module can be submitted on
|
|
the `pathlib2 bug tracker <https://github.com/mcmtroffaes/pathlib2/issues>`_.
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
Refer to the
|
|
`standard pathlib <http://docs.python.org/dev/library/pathlib.html>`_
|
|
documentation.
|
|
|
|
Known Issues
|
|
------------
|
|
|
|
For historic reasons, pathlib2 still uses bytes to represent file paths internally.
|
|
Unfortunately, on Windows with Python 2.7, the file system encoder (``mcbs``)
|
|
has only poor support for non-ascii characters,
|
|
and can silently replace non-ascii characters without warning.
|
|
For example, ``u'тест'.encode(sys.getfilesystemencoding())`` results in ``????``
|
|
which is obviously completely useless.
|
|
|
|
Therefore, on Windows with Python 2.7, until this problem is fixed upstream,
|
|
unfortunately you cannot rely on pathlib2 to support the full unicode range for filenames.
|
|
See `issue #56 <https://github.com/mcmtroffaes/pathlib2/issues/56>`_ for more details.
|
|
|
|
.. |travis| image:: https://travis-ci.org/mcmtroffaes/pathlib2.png?branch=develop
|
|
:target: https://travis-ci.org/mcmtroffaes/pathlib2
|
|
:alt: travis-ci
|
|
|
|
.. |appveyor| image:: https://ci.appveyor.com/api/projects/status/baddx3rpet2wyi2c?svg=true
|
|
:target: https://ci.appveyor.com/project/mcmtroffaes/pathlib2
|
|
:alt: appveyor
|
|
|
|
.. |codecov| image:: https://codecov.io/gh/mcmtroffaes/pathlib2/branch/develop/graph/badge.svg
|
|
:target: https://codecov.io/gh/mcmtroffaes/pathlib2
|
|
:alt: codecov
|
|
|
|
|
|
|