File: README.md

package info (click to toggle)
python-rpaths 1.0.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 236 kB
  • sloc: python: 1,319; makefile: 155
file content (18 lines) | stat: -rw-r--r-- 1,994 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
[![Build Status](https://github.com/remram44/rpaths/workflows/Test/badge.svg)](https://github.com/remram44/rpaths/actions)
[![Linux Build](https://travis-ci.org/remram44/rpaths.svg?branch=master)](https://travis-ci.org/remram44/rpaths)
[![Win Build](https://ci.appveyor.com/api/projects/status/s7efr8aoqkyp69t0/branch/master)](https://ci.appveyor.com/project/remram44/rpaths)
[![Coverage Status](http://codecov.io/github/remram44/rpaths/coverage.svg?branch=master)](http://codecov.io/github/remram44/rpaths/coverage.svg?branch=master)

rpaths
======

rpaths is yet another path manipulation library.

The [full documentation is built by ReadTheDocs](http://rpaths.remram.fr/en/latest/).

It pains me that I should have to write this, however after a survey of the existing packages, including [pathlib](https://docs.python.org/3/library/pathlib.html) (included in the Python standard library since 3.4, see [PEP 428](http://legacy.python.org/dev/peps/pep-0428/)), it appears that every one of them chokes on one valid filename or another.

* [Unipath](https://github.com/mikeorr/Unipath) is very close. In fact it is, with pathlib, one of the main inspirations for this work. Unfortunately it makes its path inherit from unicode or bytes, which makes the abstract/concrete class separation too tricky.
* [pathlib](https://bitbucket.org/pitrou/pathlib/) is affected with [a bug preventing it from representing some filenames on Windows on Python 2](https://bitbucket.org/pitrou/pathlib/issue/25); this bug was marked as wontfix. Furthermore, it works very differently on Python 2 and 3, which I believe is very counter-productive.
* [path.py](https://github.com/jaraco/path.py) is affected with [a bug making it fail when encountering some filenames on POSIX](https://github.com/jaraco/path.py/issues/61). This is also believed to allow for DoS attacks.
* [fpath](https://github.com/wackywendell/fpath) is affected with the [same bug](https://github.com/wackywendell/fpath/issues/5) as path.py.