File: UPGRADING.rst

package info (click to toggle)
python-pathspec 1.0.4-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 1,140 kB
  • sloc: python: 9,685; makefile: 14
file content (40 lines) | stat: -rw-r--r-- 1,769 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

Upgrade Guide
=============


From 0.12.1 to 1.0.0
--------------------

`PathSpec`:

- The "gitwildmatch" pattern has been replaced by "gitignore". Use ``PathSpec.from_lines('gitignore', ...)`` instead of ``PathSpec.from_lines('gitwildmatch', ...)``.

`PathSpec.from_lines('gitignore', ...)`:

- Patterns of the form "``foo/*``" will no longer match files in subdirectories. "``foo/test.json``" will match, but "``foo/bar/hello.c``" will no longer match. `GitIgnoreSpec` will continue to match those files. See `Issue #95`_.
- The exact pattern "``/``" will now match every file (equivalent to "``**``"). `GitIgnoreSpec` will continue to discard this pattern.

`PathSpec.from_lines('gitwildmatch', ...)`:

- "gitwildmatch" patterns are deprecated and will be removed in a future version.
- Its behavior is unchanged and does not have the changes documented above for "gitignore" patterns.
- To maintain this exact behavior, `GitIgnoreSpecPattern` can be used, though this use is discouraged because it's a hybrid between Git's behavior and the `gitignore`_ docs.

`GitIgnoreSpec`:

- No changes.

`GitWildMatchPattern`:

- This class is deprecated and will be removed in a future version.
- This has been split into `pathspec.patterns.gitignore.basic.GitIgnoreBasicPattern` and `pathspec.patterns.gitignore.spec.GitIgnoreSpecPattern`. `GitIgnoreSpecPattern` is the unchanged implementation. `GitIgnoreBasicPattern` has the changes documented above for "gitignore".

`GitWildMatchPatternError`:

- This class is deprecated and will be removed in a future version.
- This has been renamed to `pathspec.patterns.gitignore.GitIgnorePatternError`.


.. _`Issue #95`: https://github.com/cpburnz/python-pathspec/issues/95
.. _`gitignore`: https://git-scm.com/docs/gitignore