comparison env/lib/python3.7/site-packages/pathlib2-2.3.5.dist-info/DESCRIPTION.rst @ 0:26e78fe6e8c4 draft

"planemo upload commit c699937486c35866861690329de38ec1a5d9f783"
author shellac
date Sat, 02 May 2020 07:14:21 -0400
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:26e78fe6e8c4
1 The `old pathlib <https://bitbucket.org/pitrou/pathlib>`_
2 module on bitbucket is in bugfix-only mode.
3 The goal of pathlib2 is to provide a backport of
4 `standard pathlib <http://docs.python.org/dev/library/pathlib.html>`_
5 module which tracks the standard library module,
6 so all the newest features of the standard pathlib can be
7 used also on older Python versions.
8
9 Download
10 --------
11
12 Standalone releases are available on PyPI:
13 http://pypi.python.org/pypi/pathlib2/
14
15 Development
16 -----------
17
18 The main development takes place in the Python standard library: see
19 the `Python developer's guide <http://docs.python.org/devguide/>`_.
20 In particular, new features should be submitted to the
21 `Python bug tracker <http://bugs.python.org/>`_.
22
23 Issues that occur in this backport, but that do not occur not in the
24 standard Python pathlib module can be submitted on
25 the `pathlib2 bug tracker <https://github.com/mcmtroffaes/pathlib2/issues>`_.
26
27 Documentation
28 -------------
29
30 Refer to the
31 `standard pathlib <http://docs.python.org/dev/library/pathlib.html>`_
32 documentation.
33
34 Known Issues
35 ------------
36
37 For historic reasons, pathlib2 still uses bytes to represent file paths internally.
38 Unfortunately, on Windows with Python 2.7, the file system encoder (``mcbs``)
39 has only poor support for non-ascii characters,
40 and can silently replace non-ascii characters without warning.
41 For example, ``u'ั‚ะตัั‚'.encode(sys.getfilesystemencoding())`` results in ``????``
42 which is obviously completely useless.
43
44 Therefore, on Windows with Python 2.7, until this problem is fixed upstream,
45 unfortunately you cannot rely on pathlib2 to support the full unicode range for filenames.
46 See `issue #56 <https://github.com/mcmtroffaes/pathlib2/issues/56>`_ for more details.
47
48 .. |travis| image:: https://travis-ci.org/mcmtroffaes/pathlib2.png?branch=develop
49 :target: https://travis-ci.org/mcmtroffaes/pathlib2
50 :alt: travis-ci
51
52 .. |appveyor| image:: https://ci.appveyor.com/api/projects/status/baddx3rpet2wyi2c?svg=true
53 :target: https://ci.appveyor.com/project/mcmtroffaes/pathlib2
54 :alt: appveyor
55
56 .. |codecov| image:: https://codecov.io/gh/mcmtroffaes/pathlib2/branch/develop/graph/badge.svg
57 :target: https://codecov.io/gh/mcmtroffaes/pathlib2
58 :alt: codecov
59
60
61