开源软件构建与测试

Changes of Revision 2

_service:tar_scm:python-pathspec.spec Changed

@@ -1,40 +1,40 @@
 %global _empty_manifest_terminate_build 0
-Name:           python-pathspec
-Version:        0.8.1
-Release:        1
-Summary:        Utility library for gitignore style pattern matching of file paths.
-License:        MPL 2.0
-URL:            https://github.com/cpburnz/python-path-specification
-Source0:        https://files.pythonhosted.org/packages/b7/64/e097eea8dcd2b2f7df6e4425fc98e7494e37b1a6e149603c31d327080a05/pathspec-0.8.1.tar.gz
-BuildArch:      noarch
+Name:		python-pathspec
+Version:	0.11.1
+Release:	1
+Summary:	Utility library for gitignore style pattern matching of file paths.
+License:	MPL-2.0
+URL:		https://github.com/cpburnz/python-pathspec
+Source0:	https://files.pythonhosted.org/packages/95/60/d93628975242cc515ab2b8f5b2fc831d8be2eff32f5a1be4776d49305d13/pathspec-0.11.1.tar.gz
+BuildArch:	noarch
+
 %description
 pathspec is a utility library for pattern matching of file paths. So far this only includes Git's wildmatch pattern matching which itself is derived from Rsync's wildmatch. Git uses wildmatch for its gitignore files.
 
 %package -n python3-pathspec
-Summary:        Utility library for gitignore style pattern matching of file paths.
-Provides:       python-pathspec
+Summary:	Utility library for gitignore style pattern matching of file paths.
+Provides:	python-pathspec = %{version}-%{release}
 # Base build requires
-BuildRequires:  python3-devel
-BuildRequires:  python3-setuptools
-BuildRequires:  python3-pbr
-BuildRequires:  python3-pip
-BuildRequires:  python3-wheel
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pbr
+BuildRequires:	python3-pip
+BuildRequires:	python3-wheel
 %description -n python3-pathspec
 pathspec is a utility library for pattern matching of file paths. So far this only includes Git's wildmatch pattern matching which itself is derived from Rsync's wildmatch. Git uses wildmatch for its gitignore files.
 
 %package help
-Summary:        Utility library for gitignore style pattern matching of file paths.
-Provides:       python3-pathspec-doc
+Summary:	Development documents and examples for pathspec
+Provides:	python3-pathspec-doc
 %description help
 pathspec is a utility library for pattern matching of file paths. So far this only includes Git's wildmatch pattern matching which itself is derived from Rsync's wildmatch. Git uses wildmatch for its gitignore files.
 
 %prep
-%autosetup -n pathspec-0.8.1
+%autosetup -n pathspec-%{version}
 
 %build
 %py3_build
 
-
 %install
 %py3_install
 install -d -m755 %{buildroot}/%{_pkgdocdir}
@@ -42,38 +42,49 @@
 if  -d docs ; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
 if  -d example ; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
 if  -d examples ; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+if  -f README.rst ; then cp -af README.rst %{buildroot}/%{_pkgdocdir}; fi
+if  -f README.md ; then cp -af README.md %{buildroot}/%{_pkgdocdir}; fi
+if  -f README.txt ; then cp -af README.txt %{buildroot}/%{_pkgdocdir}; fi
 pushd %{buildroot}
 if  -d usr/lib ; then
-    find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
 fi
 if  -d usr/lib64 ; then
-    find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
 fi
 if  -d usr/bin ; then
-    find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
 fi
 if  -d usr/sbin ; then
-    find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
 fi
 touch doclist.lst
 if  -d usr/share/man ; then
-    find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
 fi
 popd
 mv %{buildroot}/filelist.lst .
 mv %{buildroot}/doclist.lst .
 
-%check
-%{__python3} setup.py test
-
 %files -n python3-pathspec -f filelist.lst
 %dir %{python3_sitelib}/*
 
-
 %files help -f doclist.lst
 %{_docdir}/*
 
 %changelog
+* Tue Mar 28 2023 wangjunqi <wangjunqi@kylinos.cn> - 0.11.1-1
+- Update package to version 0.11.1
+
+* Fri Dec 16 2022 jiangxinyu <jiangxinyu@kylinos.cn> - 0.10.3-1
+- Update package to version 0.10.3
+
+* Tue Nov 22 2022 wangjunqi <wangjunqi@kylinos.cn> - 0.10.2-1
+- Update package to version 0.10.2
+
+* Mon Aug 01 2022 fushanqing <fushanqing@kylinos.cn> - 0.9.0-1
+- update to 0.9.0
+
 * Wed Jul 14 2021 OpenStack_SIG <openstack@openeuler.org> - 0.8.1-1
 - Package Spec upgrade
 * Wed Jul 29 2020 Python_Bot <Python_Bot@openeuler.org>

_service Changed

_service:tar_scm:pathspec-0.8.1.tar.gz/CHANGES.rst -> _service:tar_scm:pathspec-0.11.1.tar.gz/CHANGES.rst Changed

@@ -2,12 +2,189 @@
 Change History
 ==============
 
+
+0.11.1 (2023-03-14)
+-------------------
+
+Bug fixes:
+
+- `Issue #74`_: Include directory should override exclude file.
+
+Improvements:
+
+- `Pull #75`_: Fix partially unknown PathLike type.
+- Convert `os.PathLike` to a string properly using `os.fspath`.
+
+.. _`Issue #74`: https://github.com/cpburnz/python-pathspec/issues/74
+.. _`Pull #75`: https://github.com/cpburnz/python-pathspec/pull/75
+
+
+
+0.11.0 (2023-01-24)
+-------------------
+
+Major changes:
+
+- Changed build backend to `flit_core.buildapi`_ from `setuptools.build_meta`_. Building with `setuptools` through `setup.py` is still supported for distributions that need it. See `Issue #72`_.
+
+Improvements:
+
+- `Issue #72`_/`Pull #73`_: Please consider switching the build-system to flit_core to ease setuptools bootstrap.
+
+
+.. _`flit_core.buildapi`: https://flit.pypa.io/en/latest/index.html
+.. _`Issue #72`: https://github.com/cpburnz/python-pathspec/issues/72
+.. _`Pull #73`: https://github.com/cpburnz/python-pathspec/pull/73
+
+
+0.10.3 (2022-12-09)
+-------------------
+
+New features:
+
+- Added utility function `pathspec.util.append_dir_sep()` to aid in distinguishing between directories and files on the file-system. See `Issue #65`_.
+
+Bug fixes:
+
+- `Issue #66`_/`Pull #67`_: Package not marked as py.typed.
+- `Issue #68`_: Exports are considered private.
+- `Issue #70`_/`Pull #71`_: 'Self' string literal type is Unknown in pyright.
+
+Improvements:
+
+- `Issue #65`_: Checking directories via match_file() does not work on Path objects.
+
+
+.. _`Issue #65`: https://github.com/cpburnz/python-pathspec/issues/65
+.. _`Issue #66`: https://github.com/cpburnz/python-pathspec/issues/66
+.. _`Pull #67`: https://github.com/cpburnz/python-pathspec/pull/67
+.. _`Issue #68`: https://github.com/cpburnz/python-pathspec/issues/68
+.. _`Issue #70`: https://github.com/cpburnz/python-pathspec/issues/70
+.. _`Pull #71`: https://github.com/cpburnz/python-pathspec/pull/71
+
+
+0.10.2 (2022-11-12)
+-------------------
+
+Bug fixes:
+
+- Fix failing tests on Windows.
+- Type hint on *root* parameter on `pathspec.pathspec.PathSpec.match_tree_entries()`.
+- Type hint on *root* parameter on `pathspec.pathspec.PathSpec.match_tree_files()`.
+- Type hint on *root* parameter on `pathspec.util.iter_tree_entries()`.
+- Type hint on *root* parameter on `pathspec.util.iter_tree_files()`.
+- `Issue #64`_: IndexError with my .gitignore file when trying to build a Python package.
+
+Improvements:
+
+- `Pull #58`_: CI: add GitHub Actions test workflow.
+
+
+.. _`Pull #58`: https://github.com/cpburnz/python-pathspec/pull/58
+.. _`Issue #64`: https://github.com/cpburnz/python-pathspec/issues/64
+
+
+0.10.1 (2022-09-02)
+-------------------
+
+Bug fixes:
+
+- Fix documentation on `pathspec.pattern.RegexPattern.match_file()`.
+- `Pull #60`_: Remove redundant wheel dep from pyproject.toml.
+- `Issue #61`_: Dist failure for Fedora, CentOS, EPEL.
+- `Issue #62`_: Since version 0.10.0 pure wildcard does not work in some cases.
+
+Improvements:
+
+- Restore support for legacy installations using `setup.py`. See `Issue #61`_.
+
+
+.. _`Pull #60`: https://github.com/cpburnz/python-pathspec/pull/60
+.. _`Issue #61`: https://github.com/cpburnz/python-pathspec/issues/61
+.. _`Issue #62`: https://github.com/cpburnz/python-pathspec/issues/62
+
+
+0.10.0 (2022-08-30)
+-------------------
+
+Major changes:
+
+- Dropped support of EOL Python 2.7, 3.5, 3.6. See `Issue #47`_.
+- The *gitwildmatch* pattern `dir/*` is now handled the same as `dir/`. This means `dir/*` will now match all descendants rather than only direct children. See `Issue #19`_.
+- Added `pathspec.GitIgnoreSpec` class (see new features).
+- Changed build system to `pyproject.toml`_ and build backend to `setuptools.build_meta`_ which may have unforeseen consequences.
+- Renamed GitHub project from `python-path-specification`_ to `python-pathspec`_. See `Issue #35`_.
+
+API changes:
+
+- Deprecated: `pathspec.util.match_files()` is an old function no longer used.
+- Deprecated: `pathspec.match_files()` is an old function no longer used.
+- Deprecated: `pathspec.util.normalize_files()` is no longer used.
+- Deprecated: `pathspec.util.iter_tree()` is an alias for `pathspec.util.iter_tree_files()`.
+- Deprecated: `pathspec.iter_tree()` is an alias for `pathspec.util.iter_tree_files()`.
+-	Deprecated: `pathspec.pattern.Pattern.match()` is no longer used. Use or implement
+	`pathspec.pattern.Pattern.match_file()`.
+
+New features:
+
+- Added class `pathspec.gitignore.GitIgnoreSpec` (with alias `pathspec.GitIgnoreSpec`) to implement *gitignore* behavior not possible with standard `PathSpec` class. The particular *gitignore* behavior implemented is prioritizing patterns matching the file directly over matching an ancestor directory.
+
+Bug fixes:
+
+- `Issue #19`_: Files inside an ignored sub-directory are not matched.
+- `Issue #41`_: Incorrectly (?) matches files inside directories that do match.
+- `Pull #51`_: Refactor deprecated unittest aliases for Python 3.11 compatibility.
+- `Issue #53`_: Symlink pathspec_meta.py breaks Windows.
+- `Issue #54`_: test_util.py uses os.symlink which can fail on Windows.
+- `Issue #55`_: Backslashes at start of pattern not handled correctly.
+- `Pull #56`_: pyproject.toml: include subpackages in setuptools config
+- `Issue #57`_: `!` doesn't exclude files in directories if the pattern doesn't have a trailing slash.
+
+Improvements:
+
+- Support Python 3.10, 3.11.
+- Modernize code to Python 3.7.
+- `Issue #52`_: match_files() is not a pure generator function, and it impacts tree_*() gravely.
+
+
+.. _`python-path-specification`: https://github.com/cpburnz/python-path-specification
+.. _`python-pathspec`: https://github.com/cpburnz/python-pathspec
+.. _`pyproject.toml`: https://pip.pypa.io/en/stable/reference/build-system/pyproject-toml/
+.. _`setuptools.build_meta`: https://setuptools.pypa.io/en/latest/build_meta.html
+.. _`Issue #19`: https://github.com/cpburnz/python-pathspec/issues/19
+.. _`Issue #35`: https://github.com/cpburnz/python-pathspec/issues/35
+.. _`Issue #41`: https://github.com/cpburnz/python-pathspec/issues/41
+.. _`Issue #47`: https://github.com/cpburnz/python-pathspec/issues/47
+.. _`Pull #51`: https://github.com/cpburnz/python-pathspec/pull/51
+.. _`Issue #52`: https://github.com/cpburnz/python-pathspec/issues/52
+.. _`Issue #53`: https://github.com/cpburnz/python-pathspec/issues/53
+.. _`Issue #54`: https://github.com/cpburnz/python-pathspec/issues/54
+.. _`Issue #55`: https://github.com/cpburnz/python-pathspec/issues/55
+.. _`Pull #56`: https://github.com/cpburnz/python-pathspec/pull/56
+.. _`Issue #57`: https://github.com/cpburnz/python-pathspec/issues/57
+
+
+0.9.0 (2021-07-17)
+------------------
+
+- `Issue #44`_/`Pull #50`_: Raise `GitWildMatchPatternError` for invalid git patterns.
+- `Pull #45`_: Fix for duplicate leading double-asterisk, and edge cases.
+- `Issue #46`_: Fix matching absolute paths.
+- API change: `util.normalize_files()` now returns a `Dictstr, Listpathlike` instead of a `Dictstr, pathlike`.
+- Added type hinting.
+
+.. _`Issue #44`: https://github.com/cpburnz/python-pathspec/issues/44
+.. _`Pull #45`: https://github.com/cpburnz/python-pathspec/pull/45
+.. _`Issue #46`: https://github.com/cpburnz/python-pathspec/issues/46
+.. _`Pull #50`: https://github.com/cpburnz/python-pathspec/pull/50
+
+
 0.8.1 (2020-11-07)
 ------------------
 
-- `Issue #43`_: Add support for addition operator.
+- `Pull #43`_: Add support for addition operator.
 
-.. _`Issue #43`: https://github.com/cpburnz/python-path-specification/pull/43
+.. _`Pull #43`: https://github.com/cpburnz/python-pathspec/pull/43
 
 
 0.8.0 (2020-04-09)
@@ -20,31 +197,31 @@
 - API change: `match_tree()` has been renamed to `match_tree_files()`. The old name `match_tree()` is still available as an alias.
 - API change: `match_tree_files()` now returns symlinks. This is a bug fix but it will change the returned results.
 
-.. _`Issue #30`: https://github.com/cpburnz/python-path-specification/issues/30
-.. _`Issue #31`: https://github.com/cpburnz/python-path-specification/issues/31
-.. _`Issue #34`: https://github.com/cpburnz/python-path-specification/issues/34
+.. _`Issue #30`: https://github.com/cpburnz/python-pathspec/issues/30
+.. _`Issue #31`: https://github.com/cpburnz/python-pathspec/issues/31
+.. _`Issue #34`: https://github.com/cpburnz/python-pathspec/issues/34
 
 
 0.7.0 (2019-12-27)
 ------------------
 
-- `Issue #28`_: Add support for Python 3.8, and drop Python 3.4.
-- `Issue #29`_: Publish bdist wheel.
+- `Pull #28`_: Add support for Python 3.8, and drop Python 3.4.
+- `Pull #29`_: Publish bdist wheel.
 
-.. _`Issue #28`: https://github.com/cpburnz/python-path-specification/pull/28
-.. _`Issue #29`: https://github.com/cpburnz/python-path-specification/pull/29
+.. _`Pull #28`: https://github.com/cpburnz/python-pathspec/pull/28
+.. _`Pull #29`: https://github.com/cpburnz/python-pathspec/pull/29
 
 
 0.6.0 (2019-10-03)
 ------------------
 
-- `Issue #24`_: Drop support for Python 2.6, 3.2, and 3.3.
-- `Issue #25`_: Update README.rst.
-- `Issue #26`_: Method to escape gitwildmatch.
+- `Pull #24`_: Drop support for Python 2.6, 3.2, and 3.3.
+- `Pull #25`_: Update README.rst.
+- `Pull #26`_: Method to escape gitwildmatch.
 
-.. _`Issue #24`: https://github.com/cpburnz/python-path-specification/pull/24
-.. _`Issue #25`: https://github.com/cpburnz/python-path-specification/pull/25
-.. _`Issue #26`: https://github.com/cpburnz/python-path-specification/pull/26
+.. _`Pull #24`: https://github.com/cpburnz/python-pathspec/pull/24
+.. _`Pull #25`: https://github.com/cpburnz/python-pathspec/pull/25
+.. _`Pull #26`: https://github.com/cpburnz/python-pathspec/pull/26
 
 
 0.5.9 (2018-09-15)
@@ -61,7 +238,7 @@
 - Improved byte string handling in Python 3.
 - `Issue #22`_: Handle dangling symlinks.
 
-.. _`Issue #22`: https://github.com/cpburnz/python-path-specification/issues/22
+.. _`Issue #22`: https://github.com/cpburnz/python-pathspec/issues/22
 
 
 0.5.7 (2018-08-14)
@@ -69,7 +246,7 @@
 
 - `Issue #21`_: Fix collections deprecation warning.
 
-.. _`Issue #21`: https://github.com/cpburnz/python-path-specification/issues/21
+.. _`Issue #21`: https://github.com/cpburnz/python-pathspec/issues/21
 
 
 0.5.6 (2018-04-06)
@@ -79,7 +256,7 @@
 - Improved type checking.
 - `Issue #20`_: Support current directory prefix.
 
-.. _`Issue #20`: https://github.com/cpburnz/python-path-specification/issues/20
+.. _`Issue #20`: https://github.com/cpburnz/python-pathspec/issues/20
 
 
 0.5.5 (2017-09-09)
@@ -91,22 +268,22 @@
 0.5.4 (2017-09-09)
 ------------------
 
-- `Issue #17`_: Add link to Ruby implementation of *pathspec*.
+- `Pull #17`_: Add link to Ruby implementation of *pathspec*.
 - Add sphinx documentation.
 
-.. _`Issue #17`: https://github.com/cpburnz/python-path-specification/pull/17
+.. _`Pull #17`: https://github.com/cpburnz/python-pathspec/pull/17
 
 
 0.5.3 (2017-07-01)
 ------------------
 
 - `Issue #14`_: Fix byte strings for Python 3.
-- `Issue #15`_: Include "LICENSE" in source package.
+- `Pull #15`_: Include "LICENSE" in source package.
 - `Issue #16`_: Support Python 2.6.
 
-.. _`Issue #14`: https://github.com/cpburnz/python-path-specification/issues/14
-.. _`Issue #15`: https://github.com/cpburnz/python-path-specification/pull/15
-.. _`Issue #16`: https://github.com/cpburnz/python-path-specification/issues/16
+.. _`Issue #14`: https://github.com/cpburnz/python-pathspec/issues/14
+.. _`Pull #15`: https://github.com/cpburnz/python-pathspec/pull/15
+.. _`Issue #16`: https://github.com/cpburnz/python-pathspec/issues/16
 
 
 0.5.2 (2017-04-04)
@@ -118,9 +295,9 @@
 0.5.1 (2017-04-04)
 ------------------
 
-- `Issue #13`_: Add equality methods to `PathSpec` and `RegexPattern`.
+- `Pull #13`_: Add equality methods to `PathSpec` and `RegexPattern`.
 
-.. _`Issue #13`: https://github.com/cpburnz/python-path-specification/pull/13
+.. _`Pull #13`: https://github.com/cpburnz/python-pathspec/pull/13
 
 
 0.5.0 (2016-08-22)
@@ -130,7 +307,7 @@
 - Renamed `gitignore.GitIgnorePattern` to `patterns.gitwildmatch.GitWildMatchPattern`.
 - Deprecated `gitignore.GitIgnorePattern`.
 
-.. _`Issue #12`: https://github.com/cpburnz/python-path-specification/issues/12
+.. _`Issue #12`: https://github.com/cpburnz/python-pathspec/issues/12
 
 
 0.4.0 (2016-07-15)
@@ -139,21 +316,21 @@
 - `Issue #11`_: Support converting patterns into regular expressions without compiling them.
 - API change: Subclasses of `RegexPattern` should implement `pattern_to_regex()`.
 
-.. _`Issue #11`: https://github.com/cpburnz/python-path-specification/issues/11
+.. _`Issue #11`: https://github.com/cpburnz/python-pathspec/issues/11
 
 
 0.3.4 (2015-08-24)
 ------------------
 
-- `Issue #7`_: Fixed non-recursive links.
-- `Issue #8`_: Fixed edge cases in gitignore patterns.
-- `Issue #9`_: Fixed minor usage documentation.
+- `Pull #7`_: Fixed non-recursive links.
+- `Pull #8`_: Fixed edge cases in gitignore patterns.
+- `Pull #9`_: Fixed minor usage documentation.
 - Fixed recursion detection.
 - Fixed trivial incompatibility with Python 3.2.
 
-.. _`Issue #7`: https://github.com/cpburnz/python-path-specification/pull/7
-.. _`Issue #8`: https://github.com/cpburnz/python-path-specification/pull/8
-.. _`Issue #9`: https://github.com/cpburnz/python-path-specification/pull/9
+.. _`Pull #7`: https://github.com/cpburnz/python-pathspec/pull/7
+.. _`Pull #8`: https://github.com/cpburnz/python-pathspec/pull/8
+.. _`Pull #9`: https://github.com/cpburnz/python-pathspec/pull/9
 
 
 0.3.3 (2014-11-21)
@@ -165,13 +342,13 @@
 0.3.2 (2014-11-08)
 ------------------
 
-- `Issue #5`_: Use tox for testing.
+- `Pull #5`_: Use tox for testing.
 - `Issue #6`_: Fixed matching Windows paths.
 - Improved documentation.
 - API change: `spec.match_tree()` and `spec.match_files()` now return iterators instead of sets.
 
-.. _`Issue #5`: https://github.com/cpburnz/python-path-specification/pull/5
-.. _`Issue #6`: https://github.com/cpburnz/python-path-specification/issues/6
+.. _`Pull #5`: https://github.com/cpburnz/python-pathspec/pull/5
+.. _`Issue #6`: https://github.com/cpburnz/python-pathspec/issues/6
 
 
 0.3.1 (2014-09-17)
@@ -183,12 +360,12 @@
 0.3.0 (2014-09-17)
 ------------------
 
-- `Issue #3`_: Fixed trailing slash in gitignore patterns.
-- `Issue #4`_: Fixed test for trailing slash in gitignore patterns.
+- `Pull #3`_: Fixed trailing slash in gitignore patterns.
+- `Pull #4`_: Fixed test for trailing slash in gitignore patterns.
 - Added registered patterns.
 
-.. _`Issue #3`: https://github.com/cpburnz/python-path-specification/pull/3
-.. _`Issue #4`: https://github.com/cpburnz/python-path-specification/pull/4
+.. _`Pull #3`: https://github.com/cpburnz/python-pathspec/pull/3
+.. _`Pull #4`: https://github.com/cpburnz/python-pathspec/pull/4
 
 
 0.2.2 (2013-12-17)

_service:tar_scm:pathspec-0.8.1.tar.gz/MANIFEST.in -> _service:tar_scm:pathspec-0.11.1.tar.gz/MANIFEST.in Changed

_service:tar_scm:pathspec-0.8.1.tar.gz/PKG-INFO -> _service:tar_scm:pathspec-0.11.1.tar.gz/PKG-INFO Changed

@@ -1,389 +1,582 @@
-Metadata-Version: 1.2
+Metadata-Version: 2.1
 Name: pathspec
-Version: 0.8.1
+Version: 0.11.1
 Summary: Utility library for gitignore style pattern matching of file paths.
-Home-page: https://github.com/cpburnz/python-path-specification
-Author: Caleb P. Burns
-Author-email: cpburnz@gmail.com
-License: MPL 2.0
-Description: *pathspec*: Path Specification
-        ==============================
-        
-        *pathspec* is a utility library for pattern matching of file paths. So
-        far this only includes Git's wildmatch pattern matching which itself is
-        derived from Rsync's wildmatch. Git uses wildmatch for its `gitignore`_
-        files.
-        
-        .. _`gitignore`: http://git-scm.com/docs/gitignore
-        
-        
-        Tutorial
-        --------
-        
-        Say you have a "Projects" directory and you want to back it up, but only
-        certain files, and ignore others depending on certain conditions::
-        
-        	>>> import pathspec
-        	>>> # The gitignore-style patterns for files to select, but we're including
-        	>>> # instead of ignoring.
-        	>>> spec = """
-        	...
-        	... # This is a comment because the line begins with a hash: "#"
-        	...
-        	... # Include several project directories (and all descendants) relative to
-        	... # the current directory. To reference a directory you must end with a
-        	... # slash: "/"
-        	... /project-a/
-        	... /project-b/
-        	... /project-c/
-        	...
-        	... # Patterns can be negated by prefixing with exclamation mark: "!"
-        	...
-        	... # Ignore temporary files beginning or ending with "~" and ending with
-        	... # ".swp".
-        	... !~*
-        	... !*~
-        	... !*.swp
-        	...
-        	... # These are python projects so ignore compiled python files from
-        	... # testing.
-        	... !*.pyc
-        	...
-        	... # Ignore the build directories but only directly under the project
-        	... # directories.
-        	... !/*/build/
-        	...
-        	... """
-        
-        We want to use the ``GitWildMatchPattern`` class to compile our patterns. The
-        ``PathSpec`` class provides an interface around pattern implementations::
-        
-        	>>> spec = pathspec.PathSpec.from_lines(pathspec.patterns.GitWildMatchPattern, spec.splitlines())
-        
-        That may be a mouthful but it allows for additional patterns to be implemented
-        in the future without them having to deal with anything but matching the paths
-        sent to them. ``GitWildMatchPattern`` is the implementation of the actual
-        pattern which internally gets converted into a regular expression.
-        ``PathSpec`` is a simple wrapper around a list of compiled patterns.
-        
-        To make things simpler, we can use the registered name for a pattern class
-        instead of always having to provide a reference to the class itself. The
-        ``GitWildMatchPattern`` class is registered as **gitwildmatch**::
-        
-        	>>> spec = pathspec.PathSpec.from_lines('gitwildmatch', spec.splitlines())
-        
-        If we wanted to manually compile the patterns we can just do the following::
-        
-        	>>> patterns = map(pathspec.patterns.GitWildMatchPattern, spec.splitlines())
-        	>>> spec = PathSpec(patterns)
-        
-        ``PathSpec.from_lines()`` is simply a class method which does just that.
-        
-        If you want to load the patterns from file, you can pass the file instance
-        directly as well::
-        
-        	>>> with open('patterns.list', 'r') as fh:
-        	>>>     spec = pathspec.PathSpec.from_lines('gitwildmatch', fh)
-        
-        You can perform matching on a whole directory tree with::
-        
-        	>>> matches = spec.match_tree('path/to/directory')
-        
-        Or you can perform matching on a specific set of file paths with::
-        
-        	>>> matches = spec.match_files(file_paths)
-        
-        Or check to see if an individual file matches::
-        
-        	>>> is_matched = spec.match_file(file_path)
-        
-        
-        License
-        -------
-        
-        *pathspec* is licensed under the `Mozilla Public License Version 2.0`_. See
-        `LICENSE`_ or the `FAQ`_ for more information.
-        
-        In summary, you may use *pathspec* with any closed or open source project
-        without affecting the license of the larger work so long as you:
-        
-        - give credit where credit is due,
-        
-        - and release any custom changes made to *pathspec*.
-        
-        .. _`Mozilla Public License Version 2.0`: http://www.mozilla.org/MPL/2.0
-        .. _`LICENSE`: LICENSE
-        .. _`FAQ`: http://www.mozilla.org/MPL/2.0/FAQ.html
-        
-        
-        Source
-        ------
-        
-        The source code for *pathspec* is available from the GitHub repo
-        `cpburnz/python-path-specification`_.
-        
-        .. _`cpburnz/python-path-specification`: https://github.com/cpburnz/python-path-specification
-        
-        
-        Installation
-        ------------
-        
-        *pathspec* requires the following packages:
-        
-        - `setuptools`_
-        
-        *pathspec* can be installed from source with::
-        
-        	python setup.py install
-        
-        *pathspec* is also available for install through `PyPI`_::
-        
-        	pip install pathspec
-        
-        .. _`setuptools`: https://pypi.python.org/pypi/setuptools
-        .. _`PyPI`: http://pypi.python.org/pypi/pathspec
-        
-        
-        Documentation
-        -------------
-        
-        Documentation for *pathspec* is available on `Read the Docs`_.
-        
-        .. _`Read the Docs`: http://python-path-specification.readthedocs.io
-        
-        
-        Other Languages
-        ---------------
-        
-        *pathspec* is also available as a `Ruby gem`_.
-        
-        .. _`Ruby gem`: https://github.com/highb/pathspec-ruby
-        
-        Change History
-        ==============
-        
-        0.8.1 (2020-11-07)
-        ------------------
-        
-        - `Issue #43`_: Add support for addition operator.
-        
-        .. _`Issue #43`: https://github.com/cpburnz/python-path-specification/pull/43
-        
-        
-        0.8.0 (2020-04-09)
-        ------------------
-        
-        - `Issue #30`_: Expose what patterns matched paths. Added `util.detailed_match_files()`.
-        - `Issue #31`_: `match_tree()` doesn't return symlinks.
-        - `Issue #34`_: Support `pathlib.Path`\ s.
-        - Add `PathSpec.match_tree_entries` and `util.iter_tree_entries()` to support directories and symlinks.
-        - API change: `match_tree()` has been renamed to `match_tree_files()`. The old name `match_tree()` is still available as an alias.
-        - API change: `match_tree_files()` now returns symlinks. This is a bug fix but it will change the returned results.
-        
-        .. _`Issue #30`: https://github.com/cpburnz/python-path-specification/issues/30
-        .. _`Issue #31`: https://github.com/cpburnz/python-path-specification/issues/31
-        .. _`Issue #34`: https://github.com/cpburnz/python-path-specification/issues/34
-        
-        
-        0.7.0 (2019-12-27)
-        ------------------
-        
-        - `Issue #28`_: Add support for Python 3.8, and drop Python 3.4.
-        - `Issue #29`_: Publish bdist wheel.
-        
-        .. _`Issue #28`: https://github.com/cpburnz/python-path-specification/pull/28
-        .. _`Issue #29`: https://github.com/cpburnz/python-path-specification/pull/29
-        
-        
-        0.6.0 (2019-10-03)
-        ------------------
-        
-        - `Issue #24`_: Drop support for Python 2.6, 3.2, and 3.3.
-        - `Issue #25`_: Update README.rst.
-        - `Issue #26`_: Method to escape gitwildmatch.
-        
-        .. _`Issue #24`: https://github.com/cpburnz/python-path-specification/pull/24
-        .. _`Issue #25`: https://github.com/cpburnz/python-path-specification/pull/25
-        .. _`Issue #26`: https://github.com/cpburnz/python-path-specification/pull/26
-        
-        
-        0.5.9 (2018-09-15)
-        ------------------
-        
-        - Fixed file system error handling.
-        
-        
-        0.5.8 (2018-09-15)
-        ------------------
-        
-        - Improved type checking.
-        - Created scripts to test Python 2.6 because Tox removed support for it.
-        - Improved byte string handling in Python 3.
-        - `Issue #22`_: Handle dangling symlinks.
-        
-        .. _`Issue #22`: https://github.com/cpburnz/python-path-specification/issues/22
-        
-        
-        0.5.7 (2018-08-14)
-        ------------------
-        
-        - `Issue #21`_: Fix collections deprecation warning.
-        
-        .. _`Issue #21`: https://github.com/cpburnz/python-path-specification/issues/21
-        
-        
-        0.5.6 (2018-04-06)
-        ------------------
-        
-        - Improved unit tests.
-        - Improved type checking.
-        - `Issue #20`_: Support current directory prefix.
-        
-        .. _`Issue #20`: https://github.com/cpburnz/python-path-specification/issues/20
-        
-        
-        0.5.5 (2017-09-09)
-        ------------------
-        
-        - Add documentation link to README.
-        
-        
-        0.5.4 (2017-09-09)
-        ------------------
-        
-        - `Issue #17`_: Add link to Ruby implementation of *pathspec*.
-        - Add sphinx documentation.
-        
-        .. _`Issue #17`: https://github.com/cpburnz/python-path-specification/pull/17
-        
-        
-        0.5.3 (2017-07-01)
-        ------------------
-        
-        - `Issue #14`_: Fix byte strings for Python 3.
-        - `Issue #15`_: Include "LICENSE" in source package.
-        - `Issue #16`_: Support Python 2.6.
-        
-        .. _`Issue #14`: https://github.com/cpburnz/python-path-specification/issues/14
-        .. _`Issue #15`: https://github.com/cpburnz/python-path-specification/pull/15
-        .. _`Issue #16`: https://github.com/cpburnz/python-path-specification/issues/16
-        
-        
-        0.5.2 (2017-04-04)
-        ------------------
-        
-        - Fixed change log.
-        
-        
-        0.5.1 (2017-04-04)
-        ------------------
-        
-        - `Issue #13`_: Add equality methods to `PathSpec` and `RegexPattern`.
-        
-        .. _`Issue #13`: https://github.com/cpburnz/python-path-specification/pull/13
-        
-        
-        0.5.0 (2016-08-22)
-        ------------------
-        
-        - `Issue #12`_: Add `PathSpec.match_file()`.
-        - Renamed `gitignore.GitIgnorePattern` to `patterns.gitwildmatch.GitWildMatchPattern`.
-        - Deprecated `gitignore.GitIgnorePattern`.
-        
-        .. _`Issue #12`: https://github.com/cpburnz/python-path-specification/issues/12
-        
-        
-        0.4.0 (2016-07-15)
-        ------------------
-        
-        - `Issue #11`_: Support converting patterns into regular expressions without compiling them.
-        - API change: Subclasses of `RegexPattern` should implement `pattern_to_regex()`.
-        
-        .. _`Issue #11`: https://github.com/cpburnz/python-path-specification/issues/11
-        
-        
-        0.3.4 (2015-08-24)
-        ------------------
-        
-        - `Issue #7`_: Fixed non-recursive links.
-        - `Issue #8`_: Fixed edge cases in gitignore patterns.
-        - `Issue #9`_: Fixed minor usage documentation.
-        - Fixed recursion detection.
-        - Fixed trivial incompatibility with Python 3.2.
-        
-        .. _`Issue #7`: https://github.com/cpburnz/python-path-specification/pull/7
-        .. _`Issue #8`: https://github.com/cpburnz/python-path-specification/pull/8
-        .. _`Issue #9`: https://github.com/cpburnz/python-path-specification/pull/9
-        
-        
-        0.3.3 (2014-11-21)
-        ------------------
-        
-        - Improved documentation.
-        
-        
-        0.3.2 (2014-11-08)
-        ------------------
-        
-        - `Issue #5`_: Use tox for testing.
-        - `Issue #6`_: Fixed matching Windows paths.
-        - Improved documentation.
-        - API change: `spec.match_tree()` and `spec.match_files()` now return iterators instead of sets.
-        
-        .. _`Issue #5`: https://github.com/cpburnz/python-path-specification/pull/5
-        .. _`Issue #6`: https://github.com/cpburnz/python-path-specification/issues/6
-        
-        
-        0.3.1 (2014-09-17)
-        ------------------
-        
-        - Updated README.
-        
-        
-        0.3.0 (2014-09-17)
-        ------------------
-        
-        - `Issue #3`_: Fixed trailing slash in gitignore patterns.
-        - `Issue #4`_: Fixed test for trailing slash in gitignore patterns.
-        - Added registered patterns.
-        
-        .. _`Issue #3`: https://github.com/cpburnz/python-path-specification/pull/3
-        .. _`Issue #4`: https://github.com/cpburnz/python-path-specification/pull/4
-        
-        
-        0.2.2 (2013-12-17)
-        ------------------
-        
-        - Fixed setup.py.
-        
-        
-        0.2.1 (2013-12-17)
-        ------------------
-        
-        - Added tests.
-        - Fixed comment gitignore patterns.
-        - Fixed relative path gitignore patterns.
-        
-        
-        0.2.0 (2013-12-07)
-        ------------------
-        
-        - Initial release.
-Platform: UNKNOWN
+Author-email: "Caleb P. Burns" <cpburnz@gmail.com>
+Requires-Python: >=3.7
+Description-Content-Type: text/x-rst
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 2
-Classifier: Programming Language :: Python :: 2.7
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.5
-Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
 Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
-Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*
+Project-URL: Documentation, https://python-path-specification.readthedocs.io/en/latest/index.html
+Project-URL: Issue Tracker, https://github.com/cpburnz/python-pathspec/issues
+Project-URL: Source Code, https://github.com/cpburnz/python-pathspec
+
+
+PathSpec
+========
+
+*pathspec* is a utility library for pattern matching of file paths. So
+far this only includes Git's wildmatch pattern matching which itself is
+derived from Rsync's wildmatch. Git uses wildmatch for its `gitignore`_
+files.
+
+.. _`gitignore`: http://git-scm.com/docs/gitignore
+
+
+Tutorial
+--------
+
+Say you have a "Projects" directory and you want to back it up, but only
+certain files, and ignore others depending on certain conditions::
+
+	>>> import pathspec
+	>>> # The gitignore-style patterns for files to select, but we're including
+	>>> # instead of ignoring.
+	>>> spec_text = """
+	...
+	... # This is a comment because the line begins with a hash: "#"
+	...
+	... # Include several project directories (and all descendants) relative to
+	... # the current directory. To reference a directory you must end with a
+	... # slash: "/"
+	... /project-a/
+	... /project-b/
+	... /project-c/
+	...
+	... # Patterns can be negated by prefixing with exclamation mark: "!"
+	...
+	... # Ignore temporary files beginning or ending with "~" and ending with
+	... # ".swp".
+	... !~*
+	... !*~
+	... !*.swp
+	...
+	... # These are python projects so ignore compiled python files from
+	... # testing.
+	... !*.pyc
+	...
+	... # Ignore the build directories but only directly under the project
+	... # directories.
+	... !/*/build/
+	...
+	... """
+
+We want to use the ``GitWildMatchPattern`` class to compile our patterns. The
+``PathSpec`` class provides an interface around pattern implementations::
+
+	>>> spec = pathspec.PathSpec.from_lines(pathspec.patterns.GitWildMatchPattern, spec_text.splitlines())
+
+That may be a mouthful but it allows for additional patterns to be implemented
+in the future without them having to deal with anything but matching the paths
+sent to them. ``GitWildMatchPattern`` is the implementation of the actual
+pattern which internally gets converted into a regular expression. ``PathSpec``
+is a simple wrapper around a list of compiled patterns.
+
+To make things simpler, we can use the registered name for a pattern class
+instead of always having to provide a reference to the class itself. The
+``GitWildMatchPattern`` class is registered as **gitwildmatch**::
+
+	>>> spec = pathspec.PathSpec.from_lines('gitwildmatch', spec_text.splitlines())
+
+If we wanted to manually compile the patterns we can just do the following::
+
+	>>> patterns = map(pathspec.patterns.GitWildMatchPattern, spec_text.splitlines())
+	>>> spec = PathSpec(patterns)
+
+``PathSpec.from_lines()`` is simply a class method which does just that.
+
+If you want to load the patterns from file, you can pass the file instance
+directly as well::
+
+	>>> with open('patterns.list', 'r') as fh:
+	>>>     spec = pathspec.PathSpec.from_lines('gitwildmatch', fh)
+
+You can perform matching on a whole directory tree with::
+
+	>>> matches = spec.match_tree('path/to/directory')
+
+Or you can perform matching on a specific set of file paths with::
+
+	>>> matches = spec.match_files(file_paths)
+
+Or check to see if an individual file matches::
+
+	>>> is_matched = spec.match_file(file_path)
+
+There is a specialized class, ``pathspec.GitIgnoreSpec``, which more closely
+implements the behavior of **gitignore**. This uses ``GitWildMatchPattern``
+pattern by default and handles some edge cases differently from the generic
+``PathSpec`` class. ``GitIgnoreSpec`` can be used without specifying the pattern
+factory::
+
+	>>> spec = pathspec.GitIgnoreSpec.from_lines(spec_text.splitlines())
+
+
+License
+-------
+
+*pathspec* is licensed under the `Mozilla Public License Version 2.0`_. See
+`LICENSE`_ or the `FAQ`_ for more information.
+
+In summary, you may use *pathspec* with any closed or open source project
+without affecting the license of the larger work so long as you:
+
+- give credit where credit is due,
+
+- and release any custom changes made to *pathspec*.
+
+.. _`Mozilla Public License Version 2.0`: http://www.mozilla.org/MPL/2.0
+.. _`LICENSE`: LICENSE
+.. _`FAQ`: http://www.mozilla.org/MPL/2.0/FAQ.html
+
+
+Source
+------
+
+The source code for *pathspec* is available from the GitHub repo
+`cpburnz/python-pathspec`_.
+
+.. _`cpburnz/python-pathspec`: https://github.com/cpburnz/python-pathspec
+
+
+Installation
+------------
+
+*pathspec* is available for install through `PyPI`_::
+
+	pip install pathspec
+
+*pathspec* can also be built from source. The following packages will be
+required:
+
+- `build`_ (>=0.6.0)
+
+*pathspec* can then be built and installed with::
+
+	python -m build
+	pip install dist/pathspec-*-py3-none-any.whl
+
+.. _`PyPI`: http://pypi.python.org/pypi/pathspec
+.. _`build`: https://pypi.org/project/build/
+
+
+Documentation
+-------------
+
+Documentation for *pathspec* is available on `Read the Docs`_.
+
+.. _`Read the Docs`: https://python-path-specification.readthedocs.io
+
+
+Other Languages
+---------------
+
+The related project `pathspec-ruby`_ (by *highb*) provides a similar library as
+a `Ruby gem`_.
+
+.. _`pathspec-ruby`: https://github.com/highb/pathspec-ruby
+.. _`Ruby gem`: https://rubygems.org/gems/pathspec
+
+
+
+Change History
+==============
+
+
+0.11.1 (2023-03-14)
+-------------------
+
+Bug fixes:
+
+- `Issue #74`_: Include directory should override exclude file.
+
+Improvements:
+
+- `Pull #75`_: Fix partially unknown PathLike type.
+- Convert `os.PathLike` to a string properly using `os.fspath`.
+
+.. _`Issue #74`: https://github.com/cpburnz/python-pathspec/issues/74
+.. _`Pull #75`: https://github.com/cpburnz/python-pathspec/pull/75
+
+
+
+0.11.0 (2023-01-24)
+-------------------
+
+Major changes:
+
+- Changed build backend to `flit_core.buildapi`_ from `setuptools.build_meta`_. Building with `setuptools` through `setup.py` is still supported for distributions that need it. See `Issue #72`_.
+
+Improvements:
+
+- `Issue #72`_/`Pull #73`_: Please consider switching the build-system to flit_core to ease setuptools bootstrap.
+
+
+.. _`flit_core.buildapi`: https://flit.pypa.io/en/latest/index.html
+.. _`Issue #72`: https://github.com/cpburnz/python-pathspec/issues/72
+.. _`Pull #73`: https://github.com/cpburnz/python-pathspec/pull/73
+
+
+0.10.3 (2022-12-09)
+-------------------
+
+New features:
+
+- Added utility function `pathspec.util.append_dir_sep()` to aid in distinguishing between directories and files on the file-system. See `Issue #65`_.
+
+Bug fixes:
+
+- `Issue #66`_/`Pull #67`_: Package not marked as py.typed.
+- `Issue #68`_: Exports are considered private.
+- `Issue #70`_/`Pull #71`_: 'Self' string literal type is Unknown in pyright.
+
+Improvements:
+
+- `Issue #65`_: Checking directories via match_file() does not work on Path objects.
+
+
+.. _`Issue #65`: https://github.com/cpburnz/python-pathspec/issues/65
+.. _`Issue #66`: https://github.com/cpburnz/python-pathspec/issues/66
+.. _`Pull #67`: https://github.com/cpburnz/python-pathspec/pull/67
+.. _`Issue #68`: https://github.com/cpburnz/python-pathspec/issues/68
+.. _`Issue #70`: https://github.com/cpburnz/python-pathspec/issues/70
+.. _`Pull #71`: https://github.com/cpburnz/python-pathspec/pull/71
+
+
+0.10.2 (2022-11-12)
+-------------------
+
+Bug fixes:
+
+- Fix failing tests on Windows.
+- Type hint on *root* parameter on `pathspec.pathspec.PathSpec.match_tree_entries()`.
+- Type hint on *root* parameter on `pathspec.pathspec.PathSpec.match_tree_files()`.
+- Type hint on *root* parameter on `pathspec.util.iter_tree_entries()`.
+- Type hint on *root* parameter on `pathspec.util.iter_tree_files()`.
+- `Issue #64`_: IndexError with my .gitignore file when trying to build a Python package.
+
+Improvements:
+
+- `Pull #58`_: CI: add GitHub Actions test workflow.
+
+
+.. _`Pull #58`: https://github.com/cpburnz/python-pathspec/pull/58
+.. _`Issue #64`: https://github.com/cpburnz/python-pathspec/issues/64
+
+
+0.10.1 (2022-09-02)
+-------------------
+
+Bug fixes:
+
+- Fix documentation on `pathspec.pattern.RegexPattern.match_file()`.
+- `Pull #60`_: Remove redundant wheel dep from pyproject.toml.
+- `Issue #61`_: Dist failure for Fedora, CentOS, EPEL.
+- `Issue #62`_: Since version 0.10.0 pure wildcard does not work in some cases.
+
+Improvements:
+
+- Restore support for legacy installations using `setup.py`. See `Issue #61`_.
+
+
+.. _`Pull #60`: https://github.com/cpburnz/python-pathspec/pull/60
+.. _`Issue #61`: https://github.com/cpburnz/python-pathspec/issues/61
+.. _`Issue #62`: https://github.com/cpburnz/python-pathspec/issues/62
+
+
+0.10.0 (2022-08-30)
+-------------------
+
+Major changes:
+
+- Dropped support of EOL Python 2.7, 3.5, 3.6. See `Issue #47`_.
+- The *gitwildmatch* pattern `dir/*` is now handled the same as `dir/`. This means `dir/*` will now match all descendants rather than only direct children. See `Issue #19`_.
+- Added `pathspec.GitIgnoreSpec` class (see new features).
+- Changed build system to `pyproject.toml`_ and build backend to `setuptools.build_meta`_ which may have unforeseen consequences.
+- Renamed GitHub project from `python-path-specification`_ to `python-pathspec`_. See `Issue #35`_.
+
+API changes:
+
+- Deprecated: `pathspec.util.match_files()` is an old function no longer used.
+- Deprecated: `pathspec.match_files()` is an old function no longer used.
+- Deprecated: `pathspec.util.normalize_files()` is no longer used.
+- Deprecated: `pathspec.util.iter_tree()` is an alias for `pathspec.util.iter_tree_files()`.
+- Deprecated: `pathspec.iter_tree()` is an alias for `pathspec.util.iter_tree_files()`.
+-	Deprecated: `pathspec.pattern.Pattern.match()` is no longer used. Use or implement
+	`pathspec.pattern.Pattern.match_file()`.
+
+New features:
+
+- Added class `pathspec.gitignore.GitIgnoreSpec` (with alias `pathspec.GitIgnoreSpec`) to implement *gitignore* behavior not possible with standard `PathSpec` class. The particular *gitignore* behavior implemented is prioritizing patterns matching the file directly over matching an ancestor directory.
+
+Bug fixes:
+
+- `Issue #19`_: Files inside an ignored sub-directory are not matched.
+- `Issue #41`_: Incorrectly (?) matches files inside directories that do match.
+- `Pull #51`_: Refactor deprecated unittest aliases for Python 3.11 compatibility.
+- `Issue #53`_: Symlink pathspec_meta.py breaks Windows.
+- `Issue #54`_: test_util.py uses os.symlink which can fail on Windows.
+- `Issue #55`_: Backslashes at start of pattern not handled correctly.
+- `Pull #56`_: pyproject.toml: include subpackages in setuptools config
+- `Issue #57`_: `!` doesn't exclude files in directories if the pattern doesn't have a trailing slash.
+
+Improvements:
+
+- Support Python 3.10, 3.11.
+- Modernize code to Python 3.7.
+- `Issue #52`_: match_files() is not a pure generator function, and it impacts tree_*() gravely.
+
+
+.. _`python-path-specification`: https://github.com/cpburnz/python-path-specification
+.. _`python-pathspec`: https://github.com/cpburnz/python-pathspec
+.. _`pyproject.toml`: https://pip.pypa.io/en/stable/reference/build-system/pyproject-toml/
+.. _`setuptools.build_meta`: https://setuptools.pypa.io/en/latest/build_meta.html
+.. _`Issue #19`: https://github.com/cpburnz/python-pathspec/issues/19
+.. _`Issue #35`: https://github.com/cpburnz/python-pathspec/issues/35
+.. _`Issue #41`: https://github.com/cpburnz/python-pathspec/issues/41
+.. _`Issue #47`: https://github.com/cpburnz/python-pathspec/issues/47
+.. _`Pull #51`: https://github.com/cpburnz/python-pathspec/pull/51
+.. _`Issue #52`: https://github.com/cpburnz/python-pathspec/issues/52
+.. _`Issue #53`: https://github.com/cpburnz/python-pathspec/issues/53
+.. _`Issue #54`: https://github.com/cpburnz/python-pathspec/issues/54
+.. _`Issue #55`: https://github.com/cpburnz/python-pathspec/issues/55
+.. _`Pull #56`: https://github.com/cpburnz/python-pathspec/pull/56
+.. _`Issue #57`: https://github.com/cpburnz/python-pathspec/issues/57
+
+
+0.9.0 (2021-07-17)
+------------------
+
+- `Issue #44`_/`Pull #50`_: Raise `GitWildMatchPatternError` for invalid git patterns.
+- `Pull #45`_: Fix for duplicate leading double-asterisk, and edge cases.
+- `Issue #46`_: Fix matching absolute paths.
+- API change: `util.normalize_files()` now returns a `Dictstr, Listpathlike` instead of a `Dictstr, pathlike`.
+- Added type hinting.
+
+.. _`Issue #44`: https://github.com/cpburnz/python-pathspec/issues/44
+.. _`Pull #45`: https://github.com/cpburnz/python-pathspec/pull/45
+.. _`Issue #46`: https://github.com/cpburnz/python-pathspec/issues/46
+.. _`Pull #50`: https://github.com/cpburnz/python-pathspec/pull/50
+
+
+0.8.1 (2020-11-07)
+------------------
+
+- `Pull #43`_: Add support for addition operator.
+
+.. _`Pull #43`: https://github.com/cpburnz/python-pathspec/pull/43
+
+
+0.8.0 (2020-04-09)
+------------------
+
+- `Issue #30`_: Expose what patterns matched paths. Added `util.detailed_match_files()`.
+- `Issue #31`_: `match_tree()` doesn't return symlinks.
+- `Issue #34`_: Support `pathlib.Path`\ s.
+- Add `PathSpec.match_tree_entries` and `util.iter_tree_entries()` to support directories and symlinks.
+- API change: `match_tree()` has been renamed to `match_tree_files()`. The old name `match_tree()` is still available as an alias.
+- API change: `match_tree_files()` now returns symlinks. This is a bug fix but it will change the returned results.
+
+.. _`Issue #30`: https://github.com/cpburnz/python-pathspec/issues/30
+.. _`Issue #31`: https://github.com/cpburnz/python-pathspec/issues/31
+.. _`Issue #34`: https://github.com/cpburnz/python-pathspec/issues/34
+
+
+0.7.0 (2019-12-27)
+------------------
+
+- `Pull #28`_: Add support for Python 3.8, and drop Python 3.4.
+- `Pull #29`_: Publish bdist wheel.
+
+.. _`Pull #28`: https://github.com/cpburnz/python-pathspec/pull/28
+.. _`Pull #29`: https://github.com/cpburnz/python-pathspec/pull/29
+
+
+0.6.0 (2019-10-03)
+------------------
+
+- `Pull #24`_: Drop support for Python 2.6, 3.2, and 3.3.
+- `Pull #25`_: Update README.rst.
+- `Pull #26`_: Method to escape gitwildmatch.
+
+.. _`Pull #24`: https://github.com/cpburnz/python-pathspec/pull/24
+.. _`Pull #25`: https://github.com/cpburnz/python-pathspec/pull/25
+.. _`Pull #26`: https://github.com/cpburnz/python-pathspec/pull/26
+
+
+0.5.9 (2018-09-15)
+------------------
+
+- Fixed file system error handling.
+
+
+0.5.8 (2018-09-15)
+------------------
+
+- Improved type checking.
+- Created scripts to test Python 2.6 because Tox removed support for it.
+- Improved byte string handling in Python 3.
+- `Issue #22`_: Handle dangling symlinks.
+
+.. _`Issue #22`: https://github.com/cpburnz/python-pathspec/issues/22
+
+
+0.5.7 (2018-08-14)
+------------------
+
+- `Issue #21`_: Fix collections deprecation warning.
+
+.. _`Issue #21`: https://github.com/cpburnz/python-pathspec/issues/21
+
+
+0.5.6 (2018-04-06)
+------------------
+
+- Improved unit tests.
+- Improved type checking.
+- `Issue #20`_: Support current directory prefix.
+
+.. _`Issue #20`: https://github.com/cpburnz/python-pathspec/issues/20
+
+
+0.5.5 (2017-09-09)
+------------------
+
+- Add documentation link to README.
+
+
+0.5.4 (2017-09-09)
+------------------
+
+- `Pull #17`_: Add link to Ruby implementation of *pathspec*.
+- Add sphinx documentation.
+
+.. _`Pull #17`: https://github.com/cpburnz/python-pathspec/pull/17
+
+
+0.5.3 (2017-07-01)
+------------------
+
+- `Issue #14`_: Fix byte strings for Python 3.
+- `Pull #15`_: Include "LICENSE" in source package.
+- `Issue #16`_: Support Python 2.6.
+
+.. _`Issue #14`: https://github.com/cpburnz/python-pathspec/issues/14
+.. _`Pull #15`: https://github.com/cpburnz/python-pathspec/pull/15
+.. _`Issue #16`: https://github.com/cpburnz/python-pathspec/issues/16
+
+
+0.5.2 (2017-04-04)
+------------------
+
+- Fixed change log.
+
+
+0.5.1 (2017-04-04)
+------------------
+
+- `Pull #13`_: Add equality methods to `PathSpec` and `RegexPattern`.
+
+.. _`Pull #13`: https://github.com/cpburnz/python-pathspec/pull/13
+
+
+0.5.0 (2016-08-22)
+------------------
+
+- `Issue #12`_: Add `PathSpec.match_file()`.
+- Renamed `gitignore.GitIgnorePattern` to `patterns.gitwildmatch.GitWildMatchPattern`.
+- Deprecated `gitignore.GitIgnorePattern`.
+
+.. _`Issue #12`: https://github.com/cpburnz/python-pathspec/issues/12
+
+
+0.4.0 (2016-07-15)
+------------------
+
+- `Issue #11`_: Support converting patterns into regular expressions without compiling them.
+- API change: Subclasses of `RegexPattern` should implement `pattern_to_regex()`.
+
+.. _`Issue #11`: https://github.com/cpburnz/python-pathspec/issues/11
+
+
+0.3.4 (2015-08-24)
+------------------
+
+- `Pull #7`_: Fixed non-recursive links.
+- `Pull #8`_: Fixed edge cases in gitignore patterns.
+- `Pull #9`_: Fixed minor usage documentation.
+- Fixed recursion detection.
+- Fixed trivial incompatibility with Python 3.2.
+
+.. _`Pull #7`: https://github.com/cpburnz/python-pathspec/pull/7
+.. _`Pull #8`: https://github.com/cpburnz/python-pathspec/pull/8
+.. _`Pull #9`: https://github.com/cpburnz/python-pathspec/pull/9
+
+
+0.3.3 (2014-11-21)
+------------------
+
+- Improved documentation.
+
+
+0.3.2 (2014-11-08)
+------------------
+
+- `Pull #5`_: Use tox for testing.
+- `Issue #6`_: Fixed matching Windows paths.
+- Improved documentation.
+- API change: `spec.match_tree()` and `spec.match_files()` now return iterators instead of sets.
+
+.. _`Pull #5`: https://github.com/cpburnz/python-pathspec/pull/5
+.. _`Issue #6`: https://github.com/cpburnz/python-pathspec/issues/6
+
+
+0.3.1 (2014-09-17)
+------------------
+
+- Updated README.
+
+
+0.3.0 (2014-09-17)
+------------------
+
+- `Pull #3`_: Fixed trailing slash in gitignore patterns.
+- `Pull #4`_: Fixed test for trailing slash in gitignore patterns.
+- Added registered patterns.
+
+.. _`Pull #3`: https://github.com/cpburnz/python-pathspec/pull/3
+.. _`Pull #4`: https://github.com/cpburnz/python-pathspec/pull/4
+
+
+0.2.2 (2013-12-17)
+------------------
+
+- Fixed setup.py.
+
+
+0.2.1 (2013-12-17)
+------------------
+
+- Added tests.
+- Fixed comment gitignore patterns.
+- Fixed relative path gitignore patterns.
+
+
+0.2.0 (2013-12-07)
+------------------
+
+- Initial release.
+

_service:tar_scm:pathspec-0.11.1.tar.gz/README-dist.rst Added

@@ -0,0 +1,555 @@
+
+PathSpec
+========
+
+*pathspec* is a utility library for pattern matching of file paths. So
+far this only includes Git's wildmatch pattern matching which itself is
+derived from Rsync's wildmatch. Git uses wildmatch for its `gitignore`_
+files.
+
+.. _`gitignore`: http://git-scm.com/docs/gitignore
+
+
+Tutorial
+--------
+
+Say you have a "Projects" directory and you want to back it up, but only
+certain files, and ignore others depending on certain conditions::
+
+	>>> import pathspec
+	>>> # The gitignore-style patterns for files to select, but we're including
+	>>> # instead of ignoring.
+	>>> spec_text = """
+	...
+	... # This is a comment because the line begins with a hash: "#"
+	...
+	... # Include several project directories (and all descendants) relative to
+	... # the current directory. To reference a directory you must end with a
+	... # slash: "/"
+	... /project-a/
+	... /project-b/
+	... /project-c/
+	...
+	... # Patterns can be negated by prefixing with exclamation mark: "!"
+	...
+	... # Ignore temporary files beginning or ending with "~" and ending with
+	... # ".swp".
+	... !~*
+	... !*~
+	... !*.swp
+	...
+	... # These are python projects so ignore compiled python files from
+	... # testing.
+	... !*.pyc
+	...
+	... # Ignore the build directories but only directly under the project
+	... # directories.
+	... !/*/build/
+	...
+	... """
+
+We want to use the ``GitWildMatchPattern`` class to compile our patterns. The
+``PathSpec`` class provides an interface around pattern implementations::
+
+	>>> spec = pathspec.PathSpec.from_lines(pathspec.patterns.GitWildMatchPattern, spec_text.splitlines())
+
+That may be a mouthful but it allows for additional patterns to be implemented
+in the future without them having to deal with anything but matching the paths
+sent to them. ``GitWildMatchPattern`` is the implementation of the actual
+pattern which internally gets converted into a regular expression. ``PathSpec``
+is a simple wrapper around a list of compiled patterns.
+
+To make things simpler, we can use the registered name for a pattern class
+instead of always having to provide a reference to the class itself. The
+``GitWildMatchPattern`` class is registered as **gitwildmatch**::
+
+	>>> spec = pathspec.PathSpec.from_lines('gitwildmatch', spec_text.splitlines())
+
+If we wanted to manually compile the patterns we can just do the following::
+
+	>>> patterns = map(pathspec.patterns.GitWildMatchPattern, spec_text.splitlines())
+	>>> spec = PathSpec(patterns)
+
+``PathSpec.from_lines()`` is simply a class method which does just that.
+
+If you want to load the patterns from file, you can pass the file instance
+directly as well::
+
+	>>> with open('patterns.list', 'r') as fh:
+	>>>     spec = pathspec.PathSpec.from_lines('gitwildmatch', fh)
+
+You can perform matching on a whole directory tree with::
+
+	>>> matches = spec.match_tree('path/to/directory')
+
+Or you can perform matching on a specific set of file paths with::
+
+	>>> matches = spec.match_files(file_paths)
+
+Or check to see if an individual file matches::
+
+	>>> is_matched = spec.match_file(file_path)
+
+There is a specialized class, ``pathspec.GitIgnoreSpec``, which more closely
+implements the behavior of **gitignore**. This uses ``GitWildMatchPattern``
+pattern by default and handles some edge cases differently from the generic
+``PathSpec`` class. ``GitIgnoreSpec`` can be used without specifying the pattern
+factory::
+
+	>>> spec = pathspec.GitIgnoreSpec.from_lines(spec_text.splitlines())
+
+
+License
+-------
+
+*pathspec* is licensed under the `Mozilla Public License Version 2.0`_. See
+`LICENSE`_ or the `FAQ`_ for more information.
+
+In summary, you may use *pathspec* with any closed or open source project
+without affecting the license of the larger work so long as you:
+
+- give credit where credit is due,
+
+- and release any custom changes made to *pathspec*.
+
+.. _`Mozilla Public License Version 2.0`: http://www.mozilla.org/MPL/2.0
+.. _`LICENSE`: LICENSE
+.. _`FAQ`: http://www.mozilla.org/MPL/2.0/FAQ.html
+
+
+Source
+------
+
+The source code for *pathspec* is available from the GitHub repo
+`cpburnz/python-pathspec`_.
+
+.. _`cpburnz/python-pathspec`: https://github.com/cpburnz/python-pathspec
+
+
+Installation
+------------
+
+*pathspec* is available for install through `PyPI`_::
+
+	pip install pathspec
+
+*pathspec* can also be built from source. The following packages will be
+required:
+
+- `build`_ (>=0.6.0)
+
+*pathspec* can then be built and installed with::
+
+	python -m build
+	pip install dist/pathspec-*-py3-none-any.whl
+
+.. _`PyPI`: http://pypi.python.org/pypi/pathspec
+.. _`build`: https://pypi.org/project/build/
+
+
+Documentation
+-------------
+
+Documentation for *pathspec* is available on `Read the Docs`_.
+
+.. _`Read the Docs`: https://python-path-specification.readthedocs.io
+
+
+Other Languages
+---------------
+
+The related project `pathspec-ruby`_ (by *highb*) provides a similar library as
+a `Ruby gem`_.
+
+.. _`pathspec-ruby`: https://github.com/highb/pathspec-ruby
+.. _`Ruby gem`: https://rubygems.org/gems/pathspec
+
+
+
+Change History
+==============
+
+
+0.11.1 (2023-03-14)
+-------------------
+
+Bug fixes:
+
+- `Issue #74`_: Include directory should override exclude file.
+
+Improvements:
+
+- `Pull #75`_: Fix partially unknown PathLike type.
+- Convert `os.PathLike` to a string properly using `os.fspath`.
+
+.. _`Issue #74`: https://github.com/cpburnz/python-pathspec/issues/74
+.. _`Pull #75`: https://github.com/cpburnz/python-pathspec/pull/75
+
+
+
+0.11.0 (2023-01-24)
+-------------------
+
+Major changes:
+
+- Changed build backend to `flit_core.buildapi`_ from `setuptools.build_meta`_. Building with `setuptools` through `setup.py` is still supported for distributions that need it. See `Issue #72`_.
+
+Improvements:
+
+- `Issue #72`_/`Pull #73`_: Please consider switching the build-system to flit_core to ease setuptools bootstrap.
+
+
+.. _`flit_core.buildapi`: https://flit.pypa.io/en/latest/index.html
+.. _`Issue #72`: https://github.com/cpburnz/python-pathspec/issues/72
+.. _`Pull #73`: https://github.com/cpburnz/python-pathspec/pull/73
+
+
+0.10.3 (2022-12-09)
+-------------------
+
+New features:
+
+- Added utility function `pathspec.util.append_dir_sep()` to aid in distinguishing between directories and files on the file-system. See `Issue #65`_.
+
+Bug fixes:
+
+- `Issue #66`_/`Pull #67`_: Package not marked as py.typed.
+- `Issue #68`_: Exports are considered private.
+- `Issue #70`_/`Pull #71`_: 'Self' string literal type is Unknown in pyright.
+
+Improvements:
+
+- `Issue #65`_: Checking directories via match_file() does not work on Path objects.
+
+
+.. _`Issue #65`: https://github.com/cpburnz/python-pathspec/issues/65
+.. _`Issue #66`: https://github.com/cpburnz/python-pathspec/issues/66
+.. _`Pull #67`: https://github.com/cpburnz/python-pathspec/pull/67
+.. _`Issue #68`: https://github.com/cpburnz/python-pathspec/issues/68
+.. _`Issue #70`: https://github.com/cpburnz/python-pathspec/issues/70
+.. _`Pull #71`: https://github.com/cpburnz/python-pathspec/pull/71
+
+
+0.10.2 (2022-11-12)
+-------------------
+
+Bug fixes:
+
+- Fix failing tests on Windows.
+- Type hint on *root* parameter on `pathspec.pathspec.PathSpec.match_tree_entries()`.
+- Type hint on *root* parameter on `pathspec.pathspec.PathSpec.match_tree_files()`.
+- Type hint on *root* parameter on `pathspec.util.iter_tree_entries()`.
+- Type hint on *root* parameter on `pathspec.util.iter_tree_files()`.
+- `Issue #64`_: IndexError with my .gitignore file when trying to build a Python package.
+
+Improvements:
+
+- `Pull #58`_: CI: add GitHub Actions test workflow.
+
+
+.. _`Pull #58`: https://github.com/cpburnz/python-pathspec/pull/58
+.. _`Issue #64`: https://github.com/cpburnz/python-pathspec/issues/64
+
+
+0.10.1 (2022-09-02)
+-------------------
+
+Bug fixes:
+
+- Fix documentation on `pathspec.pattern.RegexPattern.match_file()`.
+- `Pull #60`_: Remove redundant wheel dep from pyproject.toml.
+- `Issue #61`_: Dist failure for Fedora, CentOS, EPEL.
+- `Issue #62`_: Since version 0.10.0 pure wildcard does not work in some cases.
+
+Improvements:
+
+- Restore support for legacy installations using `setup.py`. See `Issue #61`_.
+
+
+.. _`Pull #60`: https://github.com/cpburnz/python-pathspec/pull/60
+.. _`Issue #61`: https://github.com/cpburnz/python-pathspec/issues/61
+.. _`Issue #62`: https://github.com/cpburnz/python-pathspec/issues/62
+
+
+0.10.0 (2022-08-30)
+-------------------
+
+Major changes:
+
+- Dropped support of EOL Python 2.7, 3.5, 3.6. See `Issue #47`_.
+- The *gitwildmatch* pattern `dir/*` is now handled the same as `dir/`. This means `dir/*` will now match all descendants rather than only direct children. See `Issue #19`_.
+- Added `pathspec.GitIgnoreSpec` class (see new features).
+- Changed build system to `pyproject.toml`_ and build backend to `setuptools.build_meta`_ which may have unforeseen consequences.
+- Renamed GitHub project from `python-path-specification`_ to `python-pathspec`_. See `Issue #35`_.
+
+API changes:
+
+- Deprecated: `pathspec.util.match_files()` is an old function no longer used.
+- Deprecated: `pathspec.match_files()` is an old function no longer used.
+- Deprecated: `pathspec.util.normalize_files()` is no longer used.
+- Deprecated: `pathspec.util.iter_tree()` is an alias for `pathspec.util.iter_tree_files()`.
+- Deprecated: `pathspec.iter_tree()` is an alias for `pathspec.util.iter_tree_files()`.
+-	Deprecated: `pathspec.pattern.Pattern.match()` is no longer used. Use or implement
+	`pathspec.pattern.Pattern.match_file()`.
+
+New features:
+
+- Added class `pathspec.gitignore.GitIgnoreSpec` (with alias `pathspec.GitIgnoreSpec`) to implement *gitignore* behavior not possible with standard `PathSpec` class. The particular *gitignore* behavior implemented is prioritizing patterns matching the file directly over matching an ancestor directory.
+
+Bug fixes:
+
+- `Issue #19`_: Files inside an ignored sub-directory are not matched.
+- `Issue #41`_: Incorrectly (?) matches files inside directories that do match.
+- `Pull #51`_: Refactor deprecated unittest aliases for Python 3.11 compatibility.
+- `Issue #53`_: Symlink pathspec_meta.py breaks Windows.
+- `Issue #54`_: test_util.py uses os.symlink which can fail on Windows.
+- `Issue #55`_: Backslashes at start of pattern not handled correctly.
+- `Pull #56`_: pyproject.toml: include subpackages in setuptools config
+- `Issue #57`_: `!` doesn't exclude files in directories if the pattern doesn't have a trailing slash.
+
+Improvements:
+
+- Support Python 3.10, 3.11.
+- Modernize code to Python 3.7.
+- `Issue #52`_: match_files() is not a pure generator function, and it impacts tree_*() gravely.
+
+
+.. _`python-path-specification`: https://github.com/cpburnz/python-path-specification
+.. _`python-pathspec`: https://github.com/cpburnz/python-pathspec
+.. _`pyproject.toml`: https://pip.pypa.io/en/stable/reference/build-system/pyproject-toml/
+.. _`setuptools.build_meta`: https://setuptools.pypa.io/en/latest/build_meta.html
+.. _`Issue #19`: https://github.com/cpburnz/python-pathspec/issues/19
+.. _`Issue #35`: https://github.com/cpburnz/python-pathspec/issues/35
+.. _`Issue #41`: https://github.com/cpburnz/python-pathspec/issues/41
+.. _`Issue #47`: https://github.com/cpburnz/python-pathspec/issues/47
+.. _`Pull #51`: https://github.com/cpburnz/python-pathspec/pull/51
+.. _`Issue #52`: https://github.com/cpburnz/python-pathspec/issues/52
+.. _`Issue #53`: https://github.com/cpburnz/python-pathspec/issues/53
+.. _`Issue #54`: https://github.com/cpburnz/python-pathspec/issues/54
+.. _`Issue #55`: https://github.com/cpburnz/python-pathspec/issues/55
+.. _`Pull #56`: https://github.com/cpburnz/python-pathspec/pull/56
+.. _`Issue #57`: https://github.com/cpburnz/python-pathspec/issues/57
+
+
+0.9.0 (2021-07-17)
+------------------
+
+- `Issue #44`_/`Pull #50`_: Raise `GitWildMatchPatternError` for invalid git patterns.
+- `Pull #45`_: Fix for duplicate leading double-asterisk, and edge cases.
+- `Issue #46`_: Fix matching absolute paths.
+- API change: `util.normalize_files()` now returns a `Dictstr, Listpathlike` instead of a `Dictstr, pathlike`.
+- Added type hinting.
+
+.. _`Issue #44`: https://github.com/cpburnz/python-pathspec/issues/44
+.. _`Pull #45`: https://github.com/cpburnz/python-pathspec/pull/45
+.. _`Issue #46`: https://github.com/cpburnz/python-pathspec/issues/46
+.. _`Pull #50`: https://github.com/cpburnz/python-pathspec/pull/50
+
+
+0.8.1 (2020-11-07)
+------------------
+
+- `Pull #43`_: Add support for addition operator.
+
+.. _`Pull #43`: https://github.com/cpburnz/python-pathspec/pull/43
+
+
+0.8.0 (2020-04-09)
+------------------
+
+- `Issue #30`_: Expose what patterns matched paths. Added `util.detailed_match_files()`.
+- `Issue #31`_: `match_tree()` doesn't return symlinks.
+- `Issue #34`_: Support `pathlib.Path`\ s.
+- Add `PathSpec.match_tree_entries` and `util.iter_tree_entries()` to support directories and symlinks.
+- API change: `match_tree()` has been renamed to `match_tree_files()`. The old name `match_tree()` is still available as an alias.
+- API change: `match_tree_files()` now returns symlinks. This is a bug fix but it will change the returned results.
+
+.. _`Issue #30`: https://github.com/cpburnz/python-pathspec/issues/30
+.. _`Issue #31`: https://github.com/cpburnz/python-pathspec/issues/31
+.. _`Issue #34`: https://github.com/cpburnz/python-pathspec/issues/34
+
+
+0.7.0 (2019-12-27)
+------------------
+
+- `Pull #28`_: Add support for Python 3.8, and drop Python 3.4.
+- `Pull #29`_: Publish bdist wheel.
+
+.. _`Pull #28`: https://github.com/cpburnz/python-pathspec/pull/28
+.. _`Pull #29`: https://github.com/cpburnz/python-pathspec/pull/29
+
+
+0.6.0 (2019-10-03)
+------------------
+
+- `Pull #24`_: Drop support for Python 2.6, 3.2, and 3.3.
+- `Pull #25`_: Update README.rst.
+- `Pull #26`_: Method to escape gitwildmatch.
+
+.. _`Pull #24`: https://github.com/cpburnz/python-pathspec/pull/24
+.. _`Pull #25`: https://github.com/cpburnz/python-pathspec/pull/25
+.. _`Pull #26`: https://github.com/cpburnz/python-pathspec/pull/26
+
+
+0.5.9 (2018-09-15)
+------------------
+
+- Fixed file system error handling.
+
+
+0.5.8 (2018-09-15)
+------------------
+
+- Improved type checking.
+- Created scripts to test Python 2.6 because Tox removed support for it.
+- Improved byte string handling in Python 3.
+- `Issue #22`_: Handle dangling symlinks.
+
+.. _`Issue #22`: https://github.com/cpburnz/python-pathspec/issues/22
+
+
+0.5.7 (2018-08-14)
+------------------
+
+- `Issue #21`_: Fix collections deprecation warning.
+
+.. _`Issue #21`: https://github.com/cpburnz/python-pathspec/issues/21
+
+
+0.5.6 (2018-04-06)
+------------------
+
+- Improved unit tests.
+- Improved type checking.
+- `Issue #20`_: Support current directory prefix.
+
+.. _`Issue #20`: https://github.com/cpburnz/python-pathspec/issues/20
+
+
+0.5.5 (2017-09-09)
+------------------
+
+- Add documentation link to README.
+
+
+0.5.4 (2017-09-09)
+------------------
+
+- `Pull #17`_: Add link to Ruby implementation of *pathspec*.
+- Add sphinx documentation.
+
+.. _`Pull #17`: https://github.com/cpburnz/python-pathspec/pull/17
+
+
+0.5.3 (2017-07-01)
+------------------
+
+- `Issue #14`_: Fix byte strings for Python 3.
+- `Pull #15`_: Include "LICENSE" in source package.
+- `Issue #16`_: Support Python 2.6.
+
+.. _`Issue #14`: https://github.com/cpburnz/python-pathspec/issues/14
+.. _`Pull #15`: https://github.com/cpburnz/python-pathspec/pull/15
+.. _`Issue #16`: https://github.com/cpburnz/python-pathspec/issues/16
+
+
+0.5.2 (2017-04-04)
+------------------
+
+- Fixed change log.
+
+
+0.5.1 (2017-04-04)
+------------------
+
+- `Pull #13`_: Add equality methods to `PathSpec` and `RegexPattern`.
+
+.. _`Pull #13`: https://github.com/cpburnz/python-pathspec/pull/13
+
+
+0.5.0 (2016-08-22)
+------------------
+
+- `Issue #12`_: Add `PathSpec.match_file()`.
+- Renamed `gitignore.GitIgnorePattern` to `patterns.gitwildmatch.GitWildMatchPattern`.
+- Deprecated `gitignore.GitIgnorePattern`.
+
+.. _`Issue #12`: https://github.com/cpburnz/python-pathspec/issues/12
+
+
+0.4.0 (2016-07-15)
+------------------
+
+- `Issue #11`_: Support converting patterns into regular expressions without compiling them.
+- API change: Subclasses of `RegexPattern` should implement `pattern_to_regex()`.
+
+.. _`Issue #11`: https://github.com/cpburnz/python-pathspec/issues/11
+
+
+0.3.4 (2015-08-24)
+------------------
+
+- `Pull #7`_: Fixed non-recursive links.
+- `Pull #8`_: Fixed edge cases in gitignore patterns.
+- `Pull #9`_: Fixed minor usage documentation.
+- Fixed recursion detection.
+- Fixed trivial incompatibility with Python 3.2.
+
+.. _`Pull #7`: https://github.com/cpburnz/python-pathspec/pull/7
+.. _`Pull #8`: https://github.com/cpburnz/python-pathspec/pull/8
+.. _`Pull #9`: https://github.com/cpburnz/python-pathspec/pull/9
+
+
+0.3.3 (2014-11-21)
+------------------
+
+- Improved documentation.
+
+
+0.3.2 (2014-11-08)
+------------------
+
+- `Pull #5`_: Use tox for testing.
+- `Issue #6`_: Fixed matching Windows paths.
+- Improved documentation.
+- API change: `spec.match_tree()` and `spec.match_files()` now return iterators instead of sets.
+
+.. _`Pull #5`: https://github.com/cpburnz/python-pathspec/pull/5
+.. _`Issue #6`: https://github.com/cpburnz/python-pathspec/issues/6
+
+
+0.3.1 (2014-09-17)
+------------------
+
+- Updated README.
+
+
+0.3.0 (2014-09-17)
+------------------
+
+- `Pull #3`_: Fixed trailing slash in gitignore patterns.
+- `Pull #4`_: Fixed test for trailing slash in gitignore patterns.
+- Added registered patterns.
+
+.. _`Pull #3`: https://github.com/cpburnz/python-pathspec/pull/3
+.. _`Pull #4`: https://github.com/cpburnz/python-pathspec/pull/4
+
+
+0.2.2 (2013-12-17)
+------------------
+
+- Fixed setup.py.
+
+
+0.2.1 (2013-12-17)
+------------------
+
+- Added tests.
+- Fixed comment gitignore patterns.
+- Fixed relative path gitignore patterns.
+
+
+0.2.0 (2013-12-07)
+------------------
+
+- Initial release.

_service:tar_scm:pathspec-0.8.1.tar.gz/README.rst -> _service:tar_scm:pathspec-0.11.1.tar.gz/README.rst Changed

@@ -1,6 +1,6 @@
 
-*pathspec*: Path Specification
-==============================
+PathSpec
+========
 
 *pathspec* is a utility library for pattern matching of file paths. So
 far this only includes Git's wildmatch pattern matching which itself is
@@ -19,7 +19,7 @@
 	>>> import pathspec
 	>>> # The gitignore-style patterns for files to select, but we're including
 	>>> # instead of ignoring.
-	>>> spec = """
+	>>> spec_text = """
 	...
 	... # This is a comment because the line begins with a hash: "#"
 	...
@@ -51,23 +51,23 @@
 We want to use the ``GitWildMatchPattern`` class to compile our patterns. The
 ``PathSpec`` class provides an interface around pattern implementations::
 
-	>>> spec = pathspec.PathSpec.from_lines(pathspec.patterns.GitWildMatchPattern, spec.splitlines())
+	>>> spec = pathspec.PathSpec.from_lines(pathspec.patterns.GitWildMatchPattern, spec_text.splitlines())
 
 That may be a mouthful but it allows for additional patterns to be implemented
 in the future without them having to deal with anything but matching the paths
 sent to them. ``GitWildMatchPattern`` is the implementation of the actual
-pattern which internally gets converted into a regular expression.
-``PathSpec`` is a simple wrapper around a list of compiled patterns.
+pattern which internally gets converted into a regular expression. ``PathSpec``
+is a simple wrapper around a list of compiled patterns.
 
 To make things simpler, we can use the registered name for a pattern class
 instead of always having to provide a reference to the class itself. The
 ``GitWildMatchPattern`` class is registered as **gitwildmatch**::
 
-	>>> spec = pathspec.PathSpec.from_lines('gitwildmatch', spec.splitlines())
+	>>> spec = pathspec.PathSpec.from_lines('gitwildmatch', spec_text.splitlines())
 
 If we wanted to manually compile the patterns we can just do the following::
 
-	>>> patterns = map(pathspec.patterns.GitWildMatchPattern, spec.splitlines())
+	>>> patterns = map(pathspec.patterns.GitWildMatchPattern, spec_text.splitlines())
 	>>> spec = PathSpec(patterns)
 
 ``PathSpec.from_lines()`` is simply a class method which does just that.
@@ -90,6 +90,14 @@
 
 	>>> is_matched = spec.match_file(file_path)
 
+There is a specialized class, ``pathspec.GitIgnoreSpec``, which more closely
+implements the behavior of **gitignore**. This uses ``GitWildMatchPattern``
+pattern by default and handles some edge cases differently from the generic
+``PathSpec`` class. ``GitIgnoreSpec`` can be used without specifying the pattern
+factory::
+
+	>>> spec = pathspec.GitIgnoreSpec.from_lines(spec_text.splitlines())
+
 
 License
 -------
@@ -113,28 +121,30 @@
 ------
 
 The source code for *pathspec* is available from the GitHub repo
-`cpburnz/python-path-specification`_.
+`cpburnz/python-pathspec`_.
 
-.. _`cpburnz/python-path-specification`: https://github.com/cpburnz/python-path-specification
+.. _`cpburnz/python-pathspec`: https://github.com/cpburnz/python-pathspec
 
 
 Installation
 ------------
 
-*pathspec* requires the following packages:
+*pathspec* is available for install through `PyPI`_::
 
-- `setuptools`_
+	pip install pathspec
 
-*pathspec* can be installed from source with::
+*pathspec* can also be built from source. The following packages will be
+required:
 
-	python setup.py install
+- `build`_ (>=0.6.0)
 
-*pathspec* is also available for install through `PyPI`_::
+*pathspec* can then be built and installed with::
 
-	pip install pathspec
+	python -m build
+	pip install dist/pathspec-*-py3-none-any.whl
 
-.. _`setuptools`: https://pypi.python.org/pypi/setuptools
 .. _`PyPI`: http://pypi.python.org/pypi/pathspec
+.. _`build`: https://pypi.org/project/build/
 
 
 Documentation
@@ -142,12 +152,14 @@
 
 Documentation for *pathspec* is available on `Read the Docs`_.
 
-.. _`Read the Docs`: http://python-path-specification.readthedocs.io
+.. _`Read the Docs`: https://python-path-specification.readthedocs.io
 
 
 Other Languages
 ---------------
 
-*pathspec* is also available as a `Ruby gem`_.
+The related project `pathspec-ruby`_ (by *highb*) provides a similar library as
+a `Ruby gem`_.
 
-.. _`Ruby gem`: https://github.com/highb/pathspec-ruby
+.. _`pathspec-ruby`: https://github.com/highb/pathspec-ruby
+.. _`Ruby gem`: https://rubygems.org/gems/pathspec

_service:tar_scm:pathspec-0.11.1.tar.gz/doc/Makefile Added

_service:tar_scm:pathspec-0.11.1.tar.gz/doc/source/api.rst Added

@@ -0,0 +1,70 @@
+
+API
+===
+
+pathspec
+--------
+
+.. automodule:: pathspec
+
+
+pathspec.pathspec
+-----------------
+
+.. automodule:: pathspec.pathspec
+
+	.. autoclass:: PathSpec
+		:members:
+		:show-inheritance:
+		:special-members: __init__, __eq__, __len__
+
+
+pathspec.gitignore
+------------------
+
+.. automodule:: pathspec.gitignore
+
+	.. autoclass:: GitIgnoreSpec
+		:members:
+		:show-inheritance:
+		:special-members: __init__, __eq__
+
+
+pathspec.pattern
+----------------
+
+.. automodule:: pathspec.pattern
+
+	.. autoclass:: Pattern
+		:members:
+		:show-inheritance:
+		:special-members: __init__
+
+	.. autoclass:: RegexPattern
+		:members:
+		:show-inheritance:
+		:special-members: __init__, __eq__
+
+	.. autoclass:: RegexMatchResult
+		:members:
+		:show-inheritance:
+		:special-members: __init__
+
+
+pathspec.patterns.gitwildmatch
+------------------------------
+
+.. automodule:: pathspec.patterns.gitwildmatch
+
+	.. autoclass:: GitWildMatchPattern
+		:members:
+		:inherited-members:
+		:show-inheritance:
+
+
+pathspec.util
+-------------
+
+.. automodule:: pathspec.util
+	:members:
+	:show-inheritance:

_service:tar_scm:pathspec-0.11.1.tar.gz/doc/source/changes.rst Added

_service:tar_scm:pathspec-0.11.1.tar.gz/doc/source/conf.py Added

@@ -0,0 +1,168 @@
+# -*- coding: utf-8 -*-
+#
+# Path Specification documentation build configuration file, created by
+# sphinx-quickstart on Fri Sep  8 09:37:49 2017.
+#
+# This file is execfile()d with the current directory set to its
+# containing dir.
+#
+# Note that not all possible configuration values are present in this
+# autogenerated file.
+#
+# All configuration values have a default; values that are commented out
+# serve to show the default.
+
+import os
+import sys
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+sys.path.insert(0, os.path.abspath('../../'))
+from pathspec._meta import __author__, __copyright__, __version__
+
+
+# -- General configuration ------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#
+needs_sphinx = '1.2'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = 'sphinx.ext.autodoc', 'sphinx.ext.intersphinx', 'sphinx.ext.viewcode'
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = '_templates'
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+# source_suffix = '.rst', '.md'
+source_suffix = '.rst'
+
+# The master toctree document.
+master_doc = 'index'
+
+# General information about the project.
+project = "PathSpec"
+copyright = __copyright__.split("©")1.strip()
+author = __author__
+
+# The version info for the project you're documenting, acts as replacement for
+# |version| and |release|, also used in various other places throughout the
+# built documents.
+#
+# The short X.Y version.
+version = '.'.join(__version__.split('.', 2):2)
+# The full version, including alpha/beta/rc tags.
+release = __version__
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = None
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This patterns also effect to html_static_path and html_extra_path
+exclude_patterns = 
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# If true, `todo` and `todoList` produce output, else they produce nothing.
+todo_include_todos = False
+
+
+# -- Options for the autodoc extension -----------------------------------------
+
+autodoc_member_order = 'bysource'
+
+
+# -- Options for HTML output ----------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'default'
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#
+html_theme_options = {
+	#'collapse_navigation': True,
+	#'navigation_depth': 4
+}
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = '_static'
+
+# Custom sidebar templates, must be a dictionary that maps document names
+# to template names.
+#
+# This is required for the alabaster theme
+# refs: http://alabaster.readthedocs.io/en/latest/installation.html#sidebars
+'''
+html_sidebars = {
+	'**': 
+		'about.html',
+		'navigation.html',
+		'relations.html',  # needs 'show_related': True theme option to display
+		'searchbox.html',
+		'donate.html',
+	
+}
+'''
+
+
+# -- Options for HTMLHelp output ------------------------------------------
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = '{}doc'.format(project)
+
+
+# -- Options for LaTeX output ---------------------------------------------
+
+latex_elements = {
+	# The paper size ('letterpaper' or 'a4paper').
+	#
+	# 'papersize': 'letterpaper',
+
+	# The font size ('10pt', '11pt' or '12pt').
+	#
+	# 'pointsize': '10pt',
+
+	# Additional stuff for the LaTeX preamble.
+	#
+	# 'preamble': '',
+
+	# Latex figure (float) alignment
+	#
+	# 'figure_align': 'htbp',
+}
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass howto, manual, or own class).
+latex_documents = 
+	(master_doc, '{}.tex'.format(project), '{} Documentation'.format(project), author, 'manual'),
+
+
+
+# -- Options for manual page output ---------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = 
+	(master_doc, project, '{} Documentation'.format(project), author, 1),
+
+
+# Example configuration for intersphinx: refer to the Python standard library.
+intersphinx_mapping = {'https://docs.python.org/': None}

_service:tar_scm:pathspec-0.11.1.tar.gz/doc/source/index.rst Added

_service:tar_scm:pathspec-0.11.1.tar.gz/doc/source/readme.rst Added

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/__init__.py -> _service:tar_scm:pathspec-0.11.1.tar.gz/pathspec/__init__.py Changed

@@ -1,4 +1,3 @@
-# encoding: utf-8
 """
 The *pathspec* package provides pattern matching for file paths. So far
 this only includes Git's wildmatch pattern matching (the style used for
@@ -7,63 +6,71 @@
 The following classes are imported and made available from the root of
 the `pathspec` package:
 
-- :class:`pathspec.pathspec.PathSpec`
+-	:class:`pathspec.gitignore.GitIgnoreSpec`
 
-- :class:`pathspec.pattern.Pattern`
+-	:class:`pathspec.pathspec.PathSpec`
 
-- :class:`pathspec.pattern.RegexPattern`
+-	:class:`pathspec.pattern.Pattern`
 
-- :class:`pathspec.util.RecursionError`
+-	:class:`pathspec.pattern.RegexPattern`
+
+-	:class:`pathspec.util.RecursionError`
 
 The following functions are also imported:
 
-- :func:`pathspec.util.iter_tree`
-- :func:`pathspec.util.lookup_pattern`
-- :func:`pathspec.util.match_files`
+-	:func:`pathspec.util.lookup_pattern`
+
+The following deprecated functions are also imported to maintain
+backward compatibility:
+
+-	:func:`pathspec.util.iter_tree` which is an alias for
+	:func:`pathspec.util.iter_tree_files`.
+
+-	:func:`pathspec.util.match_files`
 """
-from __future__ import unicode_literals
-
-__author__ = "Caleb P. Burns"
-__copyright__ = "Copyright © 2013-2020 Caleb P. Burns"
-__created__ = "2013-10-12"
-__credits__ = 
-	"dahlia <https://github.com/dahlia>",
-	"highb <https://github.com/highb>",
-	"029xue <https://github.com/029xue>",
-	"mikexstudios <https://github.com/mikexstudios>",
-	"nhumrich <https://github.com/nhumrich>",
-	"davidfraser <https://github.com/davidfraser>",
-	"demurgos <https://github.com/demurgos>",
-	"ghickman <https://github.com/ghickman>",
-	"nvie <https://github.com/nvie>",
-	"adrienverge <https://github.com/adrienverge>",
-	"AndersBlomdell <https://github.com/AndersBlomdell>",
-	"highb <https://github.com/highb>",
-	"thmxv <https://github.com/thmxv>",
-	"wimglenn <https://github.com/wimglenn>",
-	"hugovk <https://github.com/hugovk>",
-	"dcecile <https://github.com/dcecile>",
-	"mroutis <https://github.com/mroutis>",
-	"jdufresne <https://github.com/jdufresne>",
-	"groodt <https://github.com/groodt>",
-	"ftrofin <https://github.com/ftrofin>",
-	"pykong <https://github.com/pykong>",
-	"nhhollander <https://github.com/nhhollander>",
-
-__email__ = "cpburnz@gmail.com"
-__license__ = "MPL 2.0"
-__project__ = "pathspec"
-__status__ = "Development"
-__updated__ = "2020-11-07"
-__version__ = "0.8.1"
 
-from .pathspec import PathSpec
-from .pattern import Pattern, RegexPattern
-from .util import iter_tree, lookup_pattern, match_files, RecursionError
+from .gitignore import (
+	GitIgnoreSpec)
+from .pathspec import (
+	PathSpec)
+from .pattern import (
+	Pattern,
+	RegexPattern)
+from .util import (
+	RecursionError,
+	iter_tree,
+	lookup_pattern,
+	match_files)
+
+from ._meta import (
+	__author__,
+	__copyright__,
+	__credits__,
+	__license__,
+	__version__,
+)
 
 # Load pattern implementations.
 from . import patterns
 
-# Expose `GitIgnorePattern` class in the root module for backward
-# compatibility with v0.4.
+# DEPRECATED: Expose the `GitIgnorePattern` class in the root module for
+# backward compatibility with v0.4.
 from .patterns.gitwildmatch import GitIgnorePattern
+
+# Declare private imports as part of the public interface. Deprecated
+# imports are deliberately excluded.
+__all__ = 
+	'GitIgnoreSpec',
+	'PathSpec',
+	'Pattern',
+	'RecursionError',
+	'RegexPattern',
+	'__author__',
+	'__copyright__',
+	'__credits__',
+	'__license__',
+	'__version__',
+	'iter_tree',
+	'lookup_pattern',
+	'match_files',
+

_service:tar_scm:pathspec-0.11.1.tar.gz/pathspec/_meta.py Added

@@ -0,0 +1,55 @@
+"""
+This module contains the project meta-data.
+"""
+
+__author__ = "Caleb P. Burns"
+__copyright__ = "Copyright © 2013-2023 Caleb P. Burns"
+__credits__ = 
+	"dahlia <https://github.com/dahlia>",
+	"highb <https://github.com/highb>",
+	"029xue <https://github.com/029xue>",
+	"mikexstudios <https://github.com/mikexstudios>",
+	"nhumrich <https://github.com/nhumrich>",
+	"davidfraser <https://github.com/davidfraser>",
+	"demurgos <https://github.com/demurgos>",
+	"ghickman <https://github.com/ghickman>",
+	"nvie <https://github.com/nvie>",
+	"adrienverge <https://github.com/adrienverge>",
+	"AndersBlomdell <https://github.com/AndersBlomdell>",
+	"thmxv <https://github.com/thmxv>",
+	"wimglenn <https://github.com/wimglenn>",
+	"hugovk <https://github.com/hugovk>",
+	"dcecile <https://github.com/dcecile>",
+	"mroutis <https://github.com/mroutis>",
+	"jdufresne <https://github.com/jdufresne>",
+	"groodt <https://github.com/groodt>",
+	"ftrofin <https://github.com/ftrofin>",
+	"pykong <https://github.com/pykong>",
+	"nhhollander <https://github.com/nhhollander>",
+	"KOLANICH <https://github.com/KOLANICH>",
+	"JonjonHays <https://github.com/JonjonHays>",
+	"Isaac0616 <https://github.com/Isaac0616>",
+	"SebastiaanZ <https://github.com/SebastiaanZ>",
+	"RoelAdriaans <https://github.com/RoelAdriaans>",
+	"raviselker <https://github.com/raviselker>",
+	"johanvergeer <https://github.com/johanvergeer>",
+	"danjer <https://github.com/danjer>",
+	"jhbuhrman <https://github.com/jhbuhrman>",
+	"WPDOrdina <https://github.com/WPDOrdina>",
+	"tirkarthi <https://github.com/tirkarthi>",
+	"jayvdb <https://github.com/jayvdb>",
+	"jwodder <https://github.com/jwodder>",
+	"kloczek <https://github.com/kloczek>",
+	"orens <https://github.com/orens>",
+	"spMohanty <https://github.com/spMohanty>",
+	"ichard26 <https://github.com/ichard26>",
+	"jack1142 <https://github.com/jack1142>",
+	"mgorny <https://github.com/mgorny>",
+	"bzakdd <https://github.com/bzakdd>",
+	"haimat <https://github.com/haimat>",
+	"Avasam <https://github.com/Avasam>",
+	"yschroeder <https://github.com/yschroeder>",
+	"axesider <https://github.com/axesider>",
+
+__license__ = "MPL 2.0"
+__version__ = "0.11.1"

_service:tar_scm:pathspec-0.11.1.tar.gz/pathspec/gitignore.py Added

@@ -0,0 +1,138 @@
+"""
+This module provides :class:`.GitIgnoreSpec` which replicates
+*.gitignore* behavior.
+"""
+
+from typing import (
+	AnyStr,
+	Callable,
+	Collection,
+	Iterable,
+	Type,
+	TypeVar,
+	Union)
+
+from .pathspec import (
+	PathSpec)
+from .pattern import (
+	Pattern)
+from .patterns.gitwildmatch import (
+	GitWildMatchPattern,
+	GitWildMatchPatternError,
+	_DIR_MARK)
+from .util import (
+	_is_iterable)
+
+Self = TypeVar("Self", bound="GitIgnoreSpec")
+"""
+:class:`GitIgnoreSpec` self type hint to support Python v<3.11 using PEP
+673 recommendation.
+"""
+
+
+class GitIgnoreSpec(PathSpec):
+	"""
+	The :class:`GitIgnoreSpec` class extends :class:`PathSpec` to
+	replicate *.gitignore* behavior.
+	"""
+
+	def __eq__(self, other: object) -> bool:
+		"""
+		Tests the equality of this gitignore-spec with *other*
+		(:class:`GitIgnoreSpec`) by comparing their :attr:`~PathSpec.patterns`
+		attributes. A non-:class:`GitIgnoreSpec` will not compare equal.
+		"""
+		if isinstance(other, GitIgnoreSpec):
+			return super().__eq__(other)
+		elif isinstance(other, PathSpec):
+			return False
+		else:
+			return NotImplemented
+
+	@classmethod
+	def from_lines(
+		cls: TypeSelf,
+		lines: IterableAnyStr,
+		pattern_factory: Unionstr, CallableAnyStr, Pattern, None = None,
+	) -> Self:
+		"""
+		Compiles the pattern lines.
+
+		*lines* (:class:`~collections.abc.Iterable`) yields each uncompiled
+		pattern (:class:`str`). This simply has to yield each line so it can
+		be a :class:`io.TextIOBase` (e.g., from :func:`open` or
+		:class:`io.StringIO`) or the result from :meth:`str.splitlines`.
+
+		*pattern_factory* can be :data:`None`, the name of a registered
+		pattern factory (:class:`str`), or a :class:`~collections.abc.Callable`
+		used to compile patterns. The callable must accept an uncompiled
+		pattern (:class:`str`) and return the compiled pattern (:class:`.Pattern`).
+		Default is :data:`None` for :class:`.GitWildMatchPattern`).
+
+		Returns the :class:`GitIgnoreSpec` instance.
+		"""
+		if pattern_factory is None:
+			pattern_factory = GitWildMatchPattern
+
+		elif (isinstance(lines, str) or callable(lines)) and _is_iterable(pattern_factory):
+			# Support reversed order of arguments from PathSpec.
+			pattern_factory, lines = lines, pattern_factory
+
+		self = super().from_lines(pattern_factory, lines)
+		return self  # type: ignore
+
+	@staticmethod
+	def _match_file(
+		patterns: CollectionGitWildMatchPattern,
+		file: str,
+	) -> bool:
+		"""
+		Matches the file to the patterns.
+
+		.. NOTE:: Subclasses of :class:`.PathSpec` may override this
+		   method as an instance method. It does not have to be a static
+		   method.
+
+		*patterns* (:class:`~collections.abc.Iterable` of :class:`~pathspec.pattern.Pattern`)
+		contains the patterns to use.
+
+		*file* (:class:`str`) is the normalized file path to be matched
+		against *patterns*.
+
+		Returns :data:`True` if *file* matched; otherwise, :data:`False`.
+		"""
+		out_matched = False
+		out_priority = 0
+		for pattern in patterns:
+			if pattern.include is not None:
+				match = pattern.match_file(file)
+				if match is not None:
+					# Pattern matched.
+
+					# Check for directory marker.
+					try:
+						dir_mark = match.match.group(_DIR_MARK)
+					except IndexError as e:
+						# NOTICE: The exact content of this error message is subject
+						# to change.
+						raise GitWildMatchPatternError((
+							f"Invalid git pattern: directory marker regex group is missing. "
+							f"Debug: file={file!r} regex={pattern.regex!r} "
+							f"group={_DIR_MARK!r} match={match.match!r}."
+						)) from e
+
+					if dir_mark:
+						# Pattern matched by a directory pattern.
+						priority = 1
+					else:
+						# Pattern matched by a file pattern.
+						priority = 2
+
+					if pattern.include and dir_mark:
+						out_matched = pattern.include
+						out_priority = priority
+					elif priority >= out_priority:
+						out_matched = pattern.include
+						out_priority = priority
+
+		return out_matched

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/pathspec.py -> _service:tar_scm:pathspec-0.11.1.tar.gz/pathspec/pathspec.py Changed

@@ -1,11 +1,42 @@
-# encoding: utf-8
 """
 This module provides an object oriented interface for pattern matching
 of files.
 """
 
+import sys
+from collections.abc import (
+	Collection as CollectionType)
+from itertools import (
+	zip_longest)
+from os import (
+	PathLike)
+from typing import (
+	AnyStr,
+	Callable,
+	Collection,
+	Iterable,
+	Iterator,
+	Optional,
+	Type,
+	TypeVar,
+	Union)
+
 from . import util
-from .compat import Collection, iterkeys, izip_longest, string_types, unicode
+from .pattern import (
+	Pattern)
+from .util import (
+	StrPath,
+	TreeEntry,
+	_filter_patterns,
+	_is_iterable,
+	match_file,
+	normalize_file)
+
+Self = TypeVar("Self", bound="PathSpec")
+"""
+:class:`PathSpec` self type hint to support Python v<3.11 using PEP 673
+recommendation.
+"""
 
 
 class PathSpec(object):
@@ -14,7 +45,7 @@
 	:class:`.Pattern` instances.
 	"""
 
-	def __init__(self, patterns):
+	def __init__(self, patterns: IterablePattern) -> None:
 		"""
 		Initializes the :class:`PathSpec` instance.
 
@@ -22,41 +53,41 @@
 		yields each compiled pattern (:class:`.Pattern`).
 		"""
 
-		self.patterns = patterns if isinstance(patterns, Collection) else list(patterns)
+		self.patterns = patterns if isinstance(patterns, CollectionType) else list(patterns)
 		"""
 		*patterns* (:class:`~collections.abc.Collection` of :class:`.Pattern`)
 		contains the compiled patterns.
 		"""
 
-	def __eq__(self, other):
+	def __eq__(self, other: object) -> bool:
 		"""
 		Tests the equality of this path-spec with *other* (:class:`PathSpec`)
 		by comparing their :attr:`~PathSpec.patterns` attributes.
 		"""
 		if isinstance(other, PathSpec):
-			paired_patterns = izip_longest(self.patterns, other.patterns)
+			paired_patterns = zip_longest(self.patterns, other.patterns)
 			return all(a == b for a, b in paired_patterns)
 		else:
 			return NotImplemented
 
-	def __len__(self):
+	def __len__(self) -> int:
 		"""
 		Returns the number of compiled patterns this path-spec contains
 		(:class:`int`).
 		"""
 		return len(self.patterns)
 
-	def __add__(self, other):
+	def __add__(self: Self, other: "PathSpec") -> Self:
 		"""
 		Combines the :attr:`Pathspec.patterns` patterns from two
 		:class:`PathSpec` instances.
 		"""
 		if isinstance(other, PathSpec):
-			return PathSpec(self.patterns + other.patterns)
+			return self.__class__(self.patterns + other.patterns)
 		else:
 			return NotImplemented
 
-	def __iadd__(self, other):
+	def __iadd__(self: Self, other: "PathSpec") -> Self:
 		"""
 		Adds the :attr:`Pathspec.patterns` patterns from one :class:`PathSpec`
 		instance to this instance.
@@ -68,7 +99,11 @@
 			return NotImplemented
 
 	@classmethod
-	def from_lines(cls, pattern_factory, lines):
+	def from_lines(
+		cls: TypeSelf,
+		pattern_factory: Unionstr, CallableAnyStr, Pattern,
+		lines: IterableAnyStr,
+	) -> Self:
 		"""
 		Compiles the pattern lines.
 
@@ -79,39 +114,28 @@
 
 		*lines* (:class:`~collections.abc.Iterable`) yields each uncompiled
 		pattern (:class:`str`). This simply has to yield each line so it can
-		be a :class:`file` (e.g., from :func:`open` or :class:`io.StringIO`)
-		or the result from :meth:`str.splitlines`.
+		be a :class:`io.TextIOBase` (e.g., from :func:`open` or
+		:class:`io.StringIO`) or the result from :meth:`str.splitlines`.
 
 		Returns the :class:`PathSpec` instance.
 		"""
-		if isinstance(pattern_factory, string_types):
+		if isinstance(pattern_factory, str):
 			pattern_factory = util.lookup_pattern(pattern_factory)
-		if not callable(pattern_factory):
-			raise TypeError("pattern_factory:{!r} is not callable.".format(pattern_factory))
-
-		if not util._is_iterable(lines):
-			raise TypeError("lines:{!r} is not an iterable.".format(lines))
-
-		lines = pattern_factory(line) for line in lines if line
-		return cls(lines)
-
-	def match_file(self, file, separators=None):
-		"""
-		Matches the file to this path-spec.
 
-		*file* (:class:`str` or :class:`~pathlib.PurePath`) is the file path
-		to be matched against :attr:`self.patterns <PathSpec.patterns>`.
+		if not callable(pattern_factory):
+			raise TypeError(f"pattern_factory:{pattern_factory!r} is not callable.")
 
-		*separators* (:class:`~collections.abc.Collection` of :class:`str`)
-		optionally contains the path separators to normalize. See
-		:func:`~pathspec.util.normalize_file` for more information.
+		if not _is_iterable(lines):
+			raise TypeError(f"lines:{lines!r} is not an iterable.")
 
-		Returns :data:`True` if *file* matched; otherwise, :data:`False`.
-		"""
-		norm_file = util.normalize_file(file, separators=separators)
-		return util.match_file(self.patterns, norm_file)
+		patterns = pattern_factory(line) for line in lines if line
+		return cls(patterns)
 
-	def match_entries(self, entries, separators=None):
+	def match_entries(
+		self,
+		entries: IterableTreeEntry,
+		separators: OptionalCollectionstr = None,
+	) -> IteratorTreeEntry:
 		"""
 		Matches the entries to this path-spec.
 
@@ -123,48 +147,84 @@
 		normalize. See :func:`~pathspec.util.normalize_file` for more
 		information.
 
-		Returns the matched entries (:class:`~collections.abc.Iterable` of
+		Returns the matched entries (:class:`~collections.abc.Iterator` of
 		:class:`~util.TreeEntry`).
 		"""
-		if not util._is_iterable(entries):
-			raise TypeError("entries:{!r} is not an iterable.".format(entries))
+		if not _is_iterable(entries):
+			raise TypeError(f"entries:{entries!r} is not an iterable.")
+
+		use_patterns = _filter_patterns(self.patterns)
+		for entry in entries:
+			norm_file = normalize_file(entry.path, separators)
+			if self._match_file(use_patterns, norm_file):
+				yield entry
+
+	# Match files using the `match_file()` utility function. Subclasses
+	# may override this method as an instance method. It does not have to
+	# be a static method.
+	_match_file = staticmethod(match_file)
+
+	def match_file(
+		self,
+		file: StrPath,
+		separators: OptionalCollectionstr = None,
+	) -> bool:
+		"""
+		Matches the file to this path-spec.
+
+		*file* (:class:`str` or :class:`os.PathLikestr`) is the file path to be
+		matched against :attr:`self.patterns <PathSpec.patterns>`.
+
+		*separators* (:class:`~collections.abc.Collection` of :class:`str`)
+		optionally contains the path separators to normalize. See
+		:func:`~pathspec.util.normalize_file` for more information.
 
-		entry_map = util._normalize_entries(entries, separators=separators)
-		match_paths = util.match_files(self.patterns, iterkeys(entry_map))
-		for path in match_paths:
-			yield entry_mappath
+		Returns :data:`True` if *file* matched; otherwise, :data:`False`.
+		"""
+		norm_file = util.normalize_file(file, separators=separators)
+		return self._match_file(self.patterns, norm_file)
 
-	def match_files(self, files, separators=None):
+	def match_files(
+		self,
+		files: IterableStrPath,
+		separators: OptionalCollectionstr = None,
+	) -> IteratorStrPath:
 		"""
 		Matches the files to this path-spec.
 
-		*files* (:class:`~collections.abc.Iterable` of :class:`str; or
-		:class:`pathlib.PurePath`) contains the file paths to be matched
-		against :attr:`self.patterns <PathSpec.patterns>`.
+		*files* (:class:`~collections.abc.Iterable` of :class:`str` or
+		:class:`os.PathLikestr`) contains the file paths to be matched against
+		:attr:`self.patterns <PathSpec.patterns>`.
 
 		*separators* (:class:`~collections.abc.Collection` of :class:`str`;
 		or :data:`None`) optionally contains the path separators to
 		normalize. See :func:`~pathspec.util.normalize_file` for more
 		information.
 
-		Returns the matched files (:class:`~collections.abc.Iterable` of
-		:class:`str`).
+		Returns the matched files (:class:`~collections.abc.Iterator` of
+		:class:`str` or :class:`os.PathLikestr`).
 		"""
-		if not util._is_iterable(files):
-			raise TypeError("files:{!r} is not an iterable.".format(files))
-
-		file_map = util.normalize_files(files, separators=separators)
-		matched_files = util.match_files(self.patterns, iterkeys(file_map))
-		for path in matched_files:
-			yield file_mappath
-
-	def match_tree_entries(self, root, on_error=None, follow_links=None):
+		if not _is_iterable(files):
+			raise TypeError(f"files:{files!r} is not an iterable.")
+
+		use_patterns = _filter_patterns(self.patterns)
+		for orig_file in files:
+			norm_file = normalize_file(orig_file, separators)
+			if self._match_file(use_patterns, norm_file):
+				yield orig_file
+
+	def match_tree_entries(
+		self,
+		root: StrPath,
+		on_error: OptionalCallable = None,
+		follow_links: Optionalbool = None,
+	) -> IteratorTreeEntry:
 		"""
 		Walks the specified root path for all files and matches them to this
 		path-spec.
 
-		*root* (:class:`str`; or :class:`pathlib.PurePath`) is the root
-		directory to search.
+		*root* (:class:`str` or :class:`os.PathLikestr`) is the root directory
+		to search.
 
 		*on_error* (:class:`~collections.abc.Callable` or :data:`None`)
 		optionally is the error handler for file-system exceptions. See
@@ -174,19 +234,24 @@
 		to walk symbolic links that resolve to directories. See
 		:func:`~pathspec.util.iter_tree_files` for more information.
 
-		Returns the matched files (:class:`~collections.abc.Iterable` of
-		:class:`str`).
+		Returns the matched files (:class:`~collections.abc.Iterator` of
+		:class:`.TreeEntry`).
 		"""
 		entries = util.iter_tree_entries(root, on_error=on_error, follow_links=follow_links)
-		return self.match_entries(entries)
-
-	def match_tree_files(self, root, on_error=None, follow_links=None):
+		yield from self.match_entries(entries)
+
+	def match_tree_files(
+		self,
+		root: StrPath,
+		on_error: OptionalCallable = None,
+		follow_links: Optionalbool = None,
+	) -> Iteratorstr:
 		"""
 		Walks the specified root path for all files and matches them to this
 		path-spec.
 
-		*root* (:class:`str`; or :class:`pathlib.PurePath`) is the root
-		directory to search for files.
+		*root* (:class:`str` or :class:`os.PathLikestr`) is the root directory
+		to search for files.
 
 		*on_error* (:class:`~collections.abc.Callable` or :data:`None`)
 		optionally is the error handler for file-system exceptions. See
@@ -200,7 +265,8 @@
 		:class:`str`).
 		"""
 		files = util.iter_tree_files(root, on_error=on_error, follow_links=follow_links)
-		return self.match_files(files)
+		yield from self.match_files(files)
 
-	# Alias `match_tree_files()` as `match_tree()`.
+	# Alias `match_tree_files()` as `match_tree()` for backward
+	# compatibility before v0.3.2.
 	match_tree = match_tree_files

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/pattern.py -> _service:tar_scm:pathspec-0.11.1.tar.gz/pathspec/pattern.py Changed

@@ -1,11 +1,20 @@
-# encoding: utf-8
 """
 This module provides the base definition for patterns.
 """
 
+import dataclasses
 import re
-
-from .compat import unicode
+import warnings
+from typing import (
+	Any,
+	AnyStr,
+	Iterable,
+	Iterator,
+	Match as MatchHint,
+	Optional,
+	Pattern as PatternHint,
+	Tuple,
+	Union)
 
 
 class Pattern(object):
@@ -16,7 +25,7 @@
 	# Make the class dict-less.
 	__slots__ = ('include',)
 
-	def __init__(self, include):
+	def __init__(self, include: Optionalbool) -> None:
 		"""
 		Initializes the :class:`Pattern` instance.
 
@@ -32,17 +41,42 @@
 		or is a null-operation (:data:`None`).
 		"""
 
-	def match(self, files):
+	def match(self, files: Iterablestr) -> Iteratorstr:
 		"""
+		DEPRECATED: This method is no longer used and has been replaced by
+		:meth:`.match_file`. Use the :meth:`.match_file` method with a loop
+		for similar results.
+
 		Matches this pattern against the specified files.
 
-		*files* (:class:`~collections.abc.Iterable` of :class:`str`) contains
-		each file relative to the root directory (e.g., ``"relative/path/to/file"``).
+		*files* (:class:`~collections.abc.Iterable` of :class:`str`)
+		contains each file relative to the root directory (e.g.,
+		:data:`"relative/path/to/file"`).
 
 		Returns an :class:`~collections.abc.Iterable` yielding each matched
 		file path (:class:`str`).
 		"""
-		raise NotImplementedError("{}.{} must override match().".format(self.__class__.__module__, self.__class__.__name__))
+		warnings.warn((
+			"{0.__module__}.{0.__qualname__}.match() is deprecated. Use "
+			"{0.__module__}.{0.__qualname__}.match_file() with a loop for "
+			"similar results."
+		).format(self.__class__), DeprecationWarning, stacklevel=2)
+
+		for file in files:
+			if self.match_file(file) is not None:
+				yield file
+
+	def match_file(self, file: str) -> OptionalAny:
+		"""
+		Matches this pattern against the specified file.
+
+		*file* (:class:`str`) is the normalized file path to match against.
+
+		Returns the match result if *file* matched; otherwise, :data:`None`.
+		"""
+		raise NotImplementedError((
+			"{0.__module__}.{0.__qualname__} must override match_file()."
+		).format(self.__class__))
 
 
 class RegexPattern(Pattern):
@@ -51,19 +85,22 @@
 	using regular expressions.
 	"""
 
-	# Make the class dict-less.
+	# Keep the class dict-less.
 	__slots__ = ('regex',)
 
-	def __init__(self, pattern, include=None):
+	def __init__(
+		self,
+		pattern: UnionAnyStr, PatternHint,
+		include: Optionalbool = None,
+	) -> None:
 		"""
 		Initializes the :class:`RegexPattern` instance.
 
-		*pattern* (:class:`unicode`, :class:`bytes`, :class:`re.RegexObject`,
-		or :data:`None`) is the pattern to compile into a regular
-		expression.
+		*pattern* (:class:`str`, :class:`bytes`, :class:`re.Pattern`, or
+		:data:`None`) is the pattern to compile into a regular expression.
 
 		*include* (:class:`bool` or :data:`None`) must be :data:`None`
-		unless *pattern* is a precompiled regular expression (:class:`re.RegexObject`)
+		unless *pattern* is a precompiled regular expression (:class:`re.Pattern`)
 		in which case it is whether matched files should be included
 		(:data:`True`), excluded (:data:`False`), or is a null operation
 		(:data:`None`).
@@ -72,14 +109,10 @@
 			   parameter.
 		"""
 
-		self.regex = None
-		"""
-		*regex* (:class:`re.RegexObject`) is the regular expression for the
-		pattern.
-		"""
-
-		if isinstance(pattern, (unicode, bytes)):
-			assert include is None, "include:{!r} must be null when pattern:{!r} is a string.".format(include, pattern)
+		if isinstance(pattern, (str, bytes)):
+			assert include is None, (
+				"include:{!r} must be null when pattern:{!r} is a string."
+			).format(include, pattern)
 			regex, include = self.pattern_to_regex(pattern)
 			# NOTE: Make sure to allow a null regular expression to be
 			# returned for a null-operation.
@@ -94,15 +127,22 @@
 		elif pattern is None:
 			# NOTE: Make sure to allow a null pattern to be passed for a
 			# null-operation.
-			assert include is None, "include:{!r} must be null when pattern:{!r} is null.".format(include, pattern)
+			assert include is None, (
+				"include:{!r} must be null when pattern:{!r} is null."
+			).format(include, pattern)
 
 		else:
-			raise TypeError("pattern:{!r} is not a string, RegexObject, or None.".format(pattern))
+			raise TypeError("pattern:{!r} is not a string, re.Pattern, or None.".format(pattern))
 
 		super(RegexPattern, self).__init__(include)
-		self.regex = regex
 
-	def __eq__(self, other):
+		self.regex: PatternHint = regex
+		"""
+		*regex* (:class:`re.Pattern`) is the regular expression for the
+		pattern.
+		"""
+
+	def __eq__(self, other: 'RegexPattern') -> bool:
 		"""
 		Tests the equality of this regex pattern with *other* (:class:`RegexPattern`)
 		by comparing their :attr:`~Pattern.include` and :attr:`~RegexPattern.regex`
@@ -113,23 +153,25 @@
 		else:
 			return NotImplemented
 
-	def match(self, files):
+	def match_file(self, file: str) -> Optional'RegexMatchResult':
 		"""
-		Matches this pattern against the specified files.
+		Matches this pattern against the specified file.
 
-		*files* (:class:`~collections.abc.Iterable` of :class:`str`)
+		*file* (:class:`str`)
 		contains each file relative to the root directory (e.g., "relative/path/to/file").
 
-		Returns an :class:`~collections.abc.Iterable` yielding each matched
-		file path (:class:`str`).
+		Returns the match result (:class:`RegexMatchResult`) if *file*
+		matched; otherwise, :data:`None`.
 		"""
 		if self.include is not None:
-			for path in files:
-				if self.regex.match(path) is not None:
-					yield path
+			match = self.regex.match(file)
+			if match is not None:
+				return RegexMatchResult(match)
+
+		return None
 
 	@classmethod
-	def pattern_to_regex(cls, pattern):
+	def pattern_to_regex(cls, pattern: str) -> Tuplestr, bool:
 		"""
 		Convert the pattern into an uncompiled regular expression.
 
@@ -144,3 +186,21 @@
 			   :data:`True`.
 		"""
 		return pattern, True
+
+
+@dataclasses.dataclass()
+class RegexMatchResult(object):
+	"""
+	The :class:`RegexMatchResult` data class is used to return information
+	about the matched regular expression.
+	"""
+
+	# Keep the class dict-less.
+	__slots__ = (
+		'match',
+	)
+
+	match: MatchHint
+	"""
+	*match* (:class:`re.Match`) is the regex match result.
+	"""

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/patterns/__init__.py -> _service:tar_scm:pathspec-0.11.1.tar.gz/pathspec/patterns/__init__.py Changed

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/patterns/gitwildmatch.py -> _service:tar_scm:pathspec-0.11.1.tar.gz/pathspec/patterns/gitwildmatch.py Changed

@@ -1,20 +1,37 @@
-# encoding: utf-8
 """
 This module implements Git's wildmatch pattern matching which itself is
 derived from Rsync's wildmatch. Git uses wildmatch for its ".gitignore"
 files.
 """
-from __future__ import unicode_literals
 
 import re
 import warnings
+from typing import (
+	AnyStr,
+	Optional,
+	Tuple)
 
 from .. import util
-from ..compat import unicode
 from ..pattern import RegexPattern
 
-#: The encoding to use when parsing a byte string pattern.
 _BYTES_ENCODING = 'latin1'
+"""
+The encoding to use when parsing a byte string pattern.
+"""
+
+_DIR_MARK = 'ps_d'
+"""
+The regex group name for the directory marker. This is only used by
+:class:`GitIgnoreSpec`.
+"""
+
+
+class GitWildMatchPatternError(ValueError):
+	"""
+	The :class:`GitWildMatchPatternError` indicates an invalid git wild match
+	pattern.
+	"""
+	pass
 
 
 class GitWildMatchPattern(RegexPattern):
@@ -27,26 +44,30 @@
 	__slots__ = ()
 
 	@classmethod
-	def pattern_to_regex(cls, pattern):
+	def pattern_to_regex(
+		cls,
+		pattern: AnyStr,
+	) -> TupleOptionalAnyStr, Optionalbool:
 		"""
 		Convert the pattern into a regular expression.
 
-		*pattern* (:class:`unicode` or :class:`bytes`) is the pattern to
-		convert into a regular expression.
+		*pattern* (:class:`str` or :class:`bytes`) is the pattern to convert
+		into a regular expression.
 
-		Returns the uncompiled regular expression (:class:`unicode`, :class:`bytes`,
-		or :data:`None`), and whether matched files should be included
+		Returns the uncompiled regular expression (:class:`str`, :class:`bytes`,
+		or :data:`None`); and whether matched files should be included
 		(:data:`True`), excluded (:data:`False`), or if it is a
 		null-operation (:data:`None`).
 		"""
-		if isinstance(pattern, unicode):
-			return_type = unicode
+		if isinstance(pattern, str):
+			return_type = str
 		elif isinstance(pattern, bytes):
 			return_type = bytes
 			pattern = pattern.decode(_BYTES_ENCODING)
 		else:
-			raise TypeError("pattern:{!r} is not a unicode or byte string.".format(pattern))
+			raise TypeError(f"pattern:{pattern!r} is not a unicode or byte string.")
 
+		original_pattern = pattern
 		pattern = pattern.strip()
 
 		if pattern.startswith('#'):
@@ -63,7 +84,6 @@
 			include = None
 
 		elif pattern:
-
 			if pattern.startswith('!'):
 				# A pattern starting with an exclamation mark ('!') negates the
 				# pattern (exclude instead of include). Escape the exclamation
@@ -75,16 +95,31 @@
 			else:
 				include = True
 
-			if pattern.startswith('\\'):
-				# Remove leading back-slash escape for escaped hash ('#') or
-				# exclamation mark ('!').
-				pattern = pattern1:
+			# Allow a regex override for edge cases that cannot be handled
+			# through normalization.
+			override_regex = None
 
 			# Split pattern into segments.
 			pattern_segs = pattern.split('/')
 
 			# Normalize pattern to make processing easier.
 
+			# EDGE CASE: Deal with duplicate double-asterisk sequences.
+			# Collapse each sequence down to one double-asterisk. Iterate over
+			# the segments in reverse and remove the duplicate double
+			# asterisks as we go.
+			for i in range(len(pattern_segs) - 1, 0, -1):
+				prev = pattern_segsi-1
+				seg = pattern_segsi
+				if prev == '**' and seg == '**':
+					del pattern_segsi
+
+			if len(pattern_segs) == 2 and pattern_segs0 == '**' and not pattern_segs1:
+				# EDGE CASE: The '**/' pattern should match everything except
+				# individual files in the root directory. This case cannot be
+				# adequately handled through normalization. Use the override.
+				override_regex = f'^.+(?P<{_DIR_MARK}>/).*$'
+
 			if not pattern_segs0:
 				# A pattern beginning with a slash ('/') will only match paths
 				# directly on the root directory instead of any descendant
@@ -109,58 +144,83 @@
 				# according to `git check-ignore` (v2.4.1).
 				pass
 
+			if not pattern_segs:
+				# After resolving the edge cases, we end up with no pattern at
+				# all. This must be because the pattern is invalid.
+				raise GitWildMatchPatternError(f"Invalid git pattern: {original_pattern!r}")
+
 			if not pattern_segs-1 and len(pattern_segs) > 1:
 				# A pattern ending with a slash ('/') will match all descendant
 				# paths if it is a directory but not if it is a regular file.
-				# This is equivilent to "{pattern}/**". So, set last segment to
-				# double asterisks to include all descendants.
+				# This is equivalent to "{pattern}/**". So, set last segment to
+				# a double-asterisk to include all descendants.
 				pattern_segs-1 = '**'
 
-			# Build regular expression from pattern.
-			output = '^'
-			need_slash = False
-			end = len(pattern_segs) - 1
-			for i, seg in enumerate(pattern_segs):
-				if seg == '**':
-					if i == 0 and i == end:
-						# A pattern consisting solely of double-asterisks ('**')
-						# will match every path.
-						output.append('.+')
-					elif i == 0:
-						# A normalized pattern beginning with double-asterisks
-						# ('**') will match any leading path segments.
-						output.append('(?:.+/)?')
-						need_slash = False
-					elif i == end:
-						# A normalized pattern ending with double-asterisks ('**')
-						# will match any trailing path segments.
-						output.append('/.*')
+			if override_regex is None:
+				# Build regular expression from pattern.
+				output = '^'
+				need_slash = False
+				end = len(pattern_segs) - 1
+				for i, seg in enumerate(pattern_segs):
+					if seg == '**':
+						if i == 0 and i == end:
+							# A pattern consisting solely of double-asterisks ('**')
+							# will match every path.
+							output.append(f'^/+(?:(?P<{_DIR_MARK}>/).*)?')
+						elif i == 0:
+							# A normalized pattern beginning with double-asterisks
+							# ('**') will match any leading path segments.
+							output.append('(?:.+/)?')
+							need_slash = False
+						elif i == end:
+							# A normalized pattern ending with double-asterisks ('**')
+							# will match any trailing path segments.
+							output.append(f'(?P<{_DIR_MARK}>/).*')
+						else:
+							# A pattern with inner double-asterisks ('**') will match
+							# multiple (or zero) inner path segments.
+							output.append('(?:/.+)?')
+							need_slash = True
+
+					elif seg == '*':
+						# Match single path segment.
+						if need_slash:
+							output.append('/')
+
+						output.append('^/+')
+
+						if i == end:
+							# A pattern ending without a slash ('/') will match a file
+							# or a directory (with paths underneath it). E.g., "foo"
+							# matches "foo", "foo/bar", "foo/bar/baz", etc.
+							output.append(f'(?:(?P<{_DIR_MARK}>/).*)?')
+
+						need_slash = True
+
 					else:
-						# A pattern with inner double-asterisks ('**') will match
-						# multiple (or zero) inner path segments.
-						output.append('(?:/.+)?')
+						# Match segment glob pattern.
+						if need_slash:
+							output.append('/')
+
+						try:
+							output.append(cls._translate_segment_glob(seg))
+						except ValueError as e:
+							raise GitWildMatchPatternError(f"Invalid git pattern: {original_pattern!r}") from e
+
+						if i == end:
+							# A pattern ending without a slash ('/') will match a file
+							# or a directory (with paths underneath it). E.g., "foo"
+							# matches "foo", "foo/bar", "foo/bar/baz", etc.
+							output.append(f'(?:(?P<{_DIR_MARK}>/).*)?')
+
 						need_slash = True
-				elif seg == '*':
-					# Match single path segment.
-					if need_slash:
-						output.append('/')
-					output.append('^/+')
-					need_slash = True
-				else:
-					# Match segment glob pattern.
-					if need_slash:
-						output.append('/')
-					output.append(cls._translate_segment_glob(seg))
-					if i == end and include is True:
-						# A pattern ending without a slash ('/') will match a file
-						# or a directory (with paths underneath it). E.g., "foo"
-						# matches "foo", "foo/bar", "foo/bar/baz", etc.
-						# EDGE CASE: However, this does not hold for exclusion cases
-						# according to `git check-ignore` (v2.4.1).
-						output.append('(?:/.*)?')
-					need_slash = True
-			output.append('$')
-			regex = ''.join(output)
+
+				output.append('$')
+				regex = ''.join(output)
+
+			else:
+				# Use regex override.
+				regex = override_regex
 
 		else:
 			# A blank pattern is a null-operation (neither includes nor
@@ -174,7 +234,7 @@
 		return regex, include
 
 	@staticmethod
-	def _translate_segment_glob(pattern):
+	def _translate_segment_glob(pattern: str) -> str:
 		"""
 		Translates the glob pattern to a regular expression. This is used in
 		the constructor to translate a path segment glob pattern to its
@@ -215,28 +275,28 @@
 				regex += '^/'
 
 			elif char == '':
-				# Braket expression wildcard. Except for the beginning
-				# exclamation mark, the whole braket expression can be used
+				# Bracket expression wildcard. Except for the beginning
+				# exclamation mark, the whole bracket expression can be used
 				# directly as regex but we have to find where the expression
 				# ends.
-				# - "!" matchs '', '' and '!'.
-				# - "-" matchs '' and '-'.
-				# - "!a-" matchs any character except '', 'a' and '-'.
+				# - "!" matches '', '' and '!'.
+				# - "-" matches '' and '-'.
+				# - "!a-" matches any character except '', 'a' and '-'.
 				j = i
 				# Pass brack expression negation.
 				if j < end and patternj == '!':
 					j += 1
-				# Pass first closing braket if it is at the beginning of the
+				# Pass first closing bracket if it is at the beginning of the
 				# expression.
 				if j < end and patternj == '':
 					j += 1
-				# Find closing braket. Stop once we reach the end or find it.
+				# Find closing bracket. Stop once we reach the end or find it.
 				while j < end and patternj != '':
 					j += 1
 
 				if j < end:
-					# Found end of braket expression. Increment j to be one past
-					# the closing braket:
+					# Found end of bracket expression. Increment j to be one past
+					# the closing bracket:
 					#
 					#  ...
 					#   ^   ^
@@ -250,7 +310,7 @@
 						expr += '^'
 						i += 1
 					elif patterni == '^':
-						# POSIX declares that the regex braket expression negation
+						# POSIX declares that the regex bracket expression negation
 						# "^..." is undefined in a glob pattern. Python's
 						# `fnmatch.translate()` escapes the caret ('^') as a
 						# literal. To maintain consistency with undefined behavior,
@@ -258,41 +318,58 @@
 						expr += '\\^'
 						i += 1
 
-					# Build regex braket expression. Escape slashes so they are
+					# Build regex bracket expression. Escape slashes so they are
 					# treated as literal slashes by regex as defined by POSIX.
 					expr += patterni:j.replace('\\', '\\\\')
 
-					# Add regex braket expression to regex result.
+					# Add regex bracket expression to regex result.
 					regex += expr
 
-					# Set i to one past the closing braket.
+					# Set i to one past the closing bracket.
 					i = j
 
 				else:
-					# Failed to find closing braket, treat opening braket as a
-					# braket literal instead of as an expression.
+					# Failed to find closing bracket, treat opening bracket as a
+					# bracket literal instead of as an expression.
 					regex += '\\'
 
 			else:
 				# Regular character, escape it for regex.
 				regex += re.escape(char)
 
+		if escape:
+			raise ValueError(f"Escape character found with no next character to escape: {pattern!r}")
+
 		return regex
 
 	@staticmethod
-	def escape(s):
+	def escape(s: AnyStr) -> AnyStr:
 		"""
 		Escape special characters in the given string.
 
-		*s* (:class:`unicode` or :class:`bytes`) a filename or a string
-		that you want to escape, usually before adding it to a `.gitignore`
+		*s* (:class:`str` or :class:`bytes`) a filename or a string that you
+		want to escape, usually before adding it to a ".gitignore".
 
-		Returns the escaped string (:class:`unicode`, :class:`bytes`)
+		Returns the escaped string (:class:`str` or :class:`bytes`).
 		"""
+		if isinstance(s, str):
+			return_type = str
+			string = s
+		elif isinstance(s, bytes):
+			return_type = bytes
+			string = s.decode(_BYTES_ENCODING)
+		else:
+			raise TypeError(f"s:{s!r} is not a unicode or byte string.")
+
 		# Reference: https://git-scm.com/docs/gitignore#_pattern_format
 		meta_characters = r"!*#?"
 
-		return "".join("\\" + x if x in meta_characters else x for x in s)
+		out_string = "".join("\\" + x if x in meta_characters else x for x in string)
+
+		if return_type is bytes:
+			return out_string.encode(_BYTES_ENCODING)
+		else:
+			return out_string
 
 util.register_pattern('gitwildmatch', GitWildMatchPattern)
 
@@ -303,19 +380,22 @@
 	This class only exists to maintain compatibility with v0.4.
 	"""
 
-	def __init__(self, *args, **kw):
+	def __init__(self, *args, **kw) -> None:
 		"""
 		Warn about deprecation.
 		"""
 		self._deprecated()
-		return super(GitIgnorePattern, self).__init__(*args, **kw)
+		super(GitIgnorePattern, self).__init__(*args, **kw)
 
 	@staticmethod
-	def _deprecated():
+	def _deprecated() -> None:
 		"""
 		Warn about deprecation.
 		"""
-		warnings.warn("GitIgnorePattern ('gitignore') is deprecated. Use GitWildMatchPattern ('gitwildmatch') instead.", DeprecationWarning, stacklevel=3)
+		warnings.warn((
+			"GitIgnorePattern ('gitignore') is deprecated. Use "
+			"GitWildMatchPattern ('gitwildmatch') instead."
+		), DeprecationWarning, stacklevel=3)
 
 	@classmethod
 	def pattern_to_regex(cls, *args, **kw):

_service:tar_scm:pathspec-0.11.1.tar.gz/pathspec/py.typed Added

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/util.py -> _service:tar_scm:pathspec-0.11.1.tar.gz/pathspec/util.py Changed

@@ -1,16 +1,46 @@
-# encoding: utf-8
 """
 This module provides utility methods for dealing with path-specs.
 """
 
 import os
 import os.path
+import pathlib
 import posixpath
 import stat
-
-from .compat import Collection, Iterable, string_types, unicode
-
-NORMALIZE_PATH_SEPS = sep for sep in os.sep, os.altsep if sep and sep != posixpath.sep
+import sys
+import warnings
+from collections.abc import (
+	Collection as CollectionType,
+	Iterable as IterableType)
+from os import (
+	PathLike)
+from typing import (
+	Any,
+	AnyStr,
+	Callable,
+	Collection,
+	Dict,
+	Iterable,
+	Iterator,
+	List,
+	Optional,
+	Sequence,
+	Set,
+	Union)
+
+from .pattern import (
+	Pattern)
+
+if sys.version_info >= (3, 9):
+	StrPath = Unionstr, PathLikestr
+else:
+	StrPath = Unionstr, PathLike
+
+NORMALIZE_PATH_SEPS = 
+	__sep
+	for __sep in os.sep, os.altsep
+	if __sep and __sep != posixpath.sep
+
 """
 *NORMALIZE_PATH_SEPS* (:class:`list` of :class:`str`) contains the path
 separators that need to be normalized to the POSIX separator for the
@@ -25,7 +55,29 @@
 """
 
 
-def detailed_match_files(patterns, files, all_matches=None):
+def append_dir_sep(path: pathlib.Path) -> str:
+	"""
+	Appends the path separator to the path if the path is a directory.
+	This can be used to aid in distinguishing between directories and
+	files on the file-system by relying on the presence of a trailing path
+	separator.
+
+	*path* (:class:`pathlib.path`) is the path to use.
+
+	Returns the path (:class:`str`).
+	"""
+	str_path = str(path)
+	if path.is_dir():
+		str_path += os.sep
+
+	return str_path
+
+
+def detailed_match_files(
+	patterns: IterablePattern,
+	files: Iterablestr,
+	all_matches: Optionalbool = None,
+) -> Dictstr, 'MatchDetail':
 	"""
 	Matches the files to the patterns, and returns which patterns matched
 	the files.
@@ -43,11 +95,11 @@
 	Returns the matched files (:class:`dict`) which maps each matched file
 	(:class:`str`) to the patterns that matched in order (:class:`.MatchDetail`).
 	"""
-	all_files = files if isinstance(files, Collection) else list(files)
+	all_files = files if isinstance(files, CollectionType) else list(files)
 	return_files = {}
 	for pattern in patterns:
 		if pattern.include is not None:
-			result_files = pattern.match(all_files)
+			result_files = pattern.match(all_files)  # TODO: Replace with `.match_file()`.
 			if pattern.include:
 				# Add files and record pattern.
 				for result_file in result_files:
@@ -67,53 +119,43 @@
 	return return_files
 
 
-def _is_iterable(value):
+def _filter_patterns(patterns: IterablePattern) -> ListPattern:
 	"""
-	Check whether the value is an iterable (excludes strings).
+	Filters out null-patterns.
 
-	*value* is the value to check,
+	*patterns* (:class:`Iterable` of :class:`.Pattern`) contains the
+	patterns.
 
-	Returns whether *value* is a iterable (:class:`bool`).
+	Returns the patterns (:class:`list` of :class:`.Pattern`).
 	"""
-	return isinstance(value, Iterable) and not isinstance(value, (unicode, bytes))
+	return 
+		__pat
+		for __pat in patterns
+		if __pat.include is not None
+	
 
 
-def iter_tree_entries(root, on_error=None, follow_links=None):
+def _is_iterable(value: Any) -> bool:
 	"""
-	Walks the specified directory for all files and directories.
-
-	*root* (:class:`str`) is the root directory to search.
-
-	*on_error* (:class:`~collections.abc.Callable` or :data:`None`)
-	optionally is the error handler for file-system exceptions. It will be
-	called with the exception (:exc:`OSError`). Reraise the exception to
-	abort the walk. Default is :data:`None` to ignore file-system
-	exceptions.
-
-	*follow_links* (:class:`bool` or :data:`None`) optionally is whether
-	to walk symbolic links that resolve to directories. Default is
-	:data:`None` for :data:`True`.
+	Check whether the value is an iterable (excludes strings).
 
-	Raises :exc:`RecursionError` if recursion is detected.
+	*value* is the value to check,
 
-	Returns an :class:`~collections.abc.Iterable` yielding each file or
-	directory entry (:class:`.TreeEntry`) relative to *root*.
+	Returns whether *value* is a iterable (:class:`bool`).
 	"""
-	if on_error is not None and not callable(on_error):
-		raise TypeError("on_error:{!r} is not callable.".format(on_error))
+	return isinstance(value, IterableType) and not isinstance(value, (str, bytes))
 
-	if follow_links is None:
-		follow_links = True
 
-	for entry in _iter_tree_entries_next(os.path.abspath(root), '', {}, on_error, follow_links):
-		yield entry
-
-
-def iter_tree_files(root, on_error=None, follow_links=None):
+def iter_tree_entries(
+	root: StrPath,
+	on_error: OptionalCallable = None,
+	follow_links: Optionalbool = None,
+) -> Iterator'TreeEntry':
 	"""
-	Walks the specified directory for all files.
+	Walks the specified directory for all files and directories.
 
-	*root* (:class:`str`) is the root directory to search for files.
+	*root* (:class:`str` or :class:`os.PathLikestr`) is the root directory to
+	search.
 
 	*on_error* (:class:`~collections.abc.Callable` or :data:`None`)
 	optionally is the error handler for file-system exceptions. It will be
@@ -127,25 +169,25 @@
 
 	Raises :exc:`RecursionError` if recursion is detected.
 
-	Returns an :class:`~collections.abc.Iterable` yielding the path to
-	each file (:class:`str`) relative to *root*.
+	Returns an :class:`~collections.abc.Iterator` yielding each file or
+	directory entry (:class:`.TreeEntry`) relative to *root*.
 	"""
 	if on_error is not None and not callable(on_error):
-		raise TypeError("on_error:{!r} is not callable.".format(on_error))
+		raise TypeError(f"on_error:{on_error!r} is not callable.")
 
 	if follow_links is None:
 		follow_links = True
 
-	for entry in _iter_tree_entries_next(os.path.abspath(root), '', {}, on_error, follow_links):
-		if not entry.is_dir(follow_links):
-			yield entry.path
-
+	yield from _iter_tree_entries_next(os.path.abspath(root), '', {}, on_error, follow_links)
 
-# Alias `iter_tree_files()` as `iter_tree()`.
-iter_tree = iter_tree_files
 
-
-def _iter_tree_entries_next(root_full, dir_rel, memo, on_error, follow_links):
+def _iter_tree_entries_next(
+	root_full: str,
+	dir_rel: str,
+	memo: Dictstr, str,
+	on_error: Callable,
+	follow_links: bool,
+) -> Iterator'TreeEntry':
 	"""
 	Scan the directory for all descendant files.
 
@@ -177,42 +219,40 @@
 	else:
 		raise RecursionError(real_path=dir_real, first_path=memodir_real, second_path=dir_rel)
 
-	for node_name in os.listdir(dir_full):
-		node_rel = os.path.join(dir_rel, node_name)
-		node_full = os.path.join(root_full, node_rel)
-
-		# Inspect child node.
-		try:
-			node_lstat = os.lstat(node_full)
-		except OSError as e:
-			if on_error is not None:
-				on_error(e)
-			continue
-
-		if stat.S_ISLNK(node_lstat.st_mode):
-			# Child node is a link, inspect the target node.
-			is_link = True
+	with os.scandir(dir_full) as scan_iter:
+		node_ent: os.DirEntry
+		for node_ent in scan_iter:
+			node_rel = os.path.join(dir_rel, node_ent.name)
+
+			# Inspect child node.
 			try:
-				node_stat = os.stat(node_full)
+				node_lstat = node_ent.stat(follow_symlinks=False)
 			except OSError as e:
 				if on_error is not None:
 					on_error(e)
 				continue
-		else:
-			is_link = False
-			node_stat = node_lstat
 
-		if stat.S_ISDIR(node_stat.st_mode) and (follow_links or not is_link):
-			# Child node is a directory, recurse into it and yield its
-			# descendant files.
-			yield TreeEntry(node_name, node_rel, node_lstat, node_stat)
+			if node_ent.is_symlink():
+				# Child node is a link, inspect the target node.
+				try:
+					node_stat = node_ent.stat()
+				except OSError as e:
+					if on_error is not None:
+						on_error(e)
+					continue
+			else:
+				node_stat = node_lstat
+
+			if node_ent.is_dir(follow_symlinks=follow_links):
+				# Child node is a directory, recurse into it and yield its
+				# descendant files.
+				yield TreeEntry(node_ent.name, node_rel, node_lstat, node_stat)
 
-			for entry in _iter_tree_entries_next(root_full, node_rel, memo, on_error, follow_links):
-				yield entry
+				yield from _iter_tree_entries_next(root_full, node_rel, memo, on_error, follow_links)
 
-		elif stat.S_ISREG(node_stat.st_mode) or is_link:
-			# Child node is either a file or an unfollowed link, yield it.
-			yield TreeEntry(node_name, node_rel, node_lstat, node_stat)
+			elif node_ent.is_file() or node_ent.is_symlink():
+				# Child node is either a file or an unfollowed link, yield it.
+				yield TreeEntry(node_ent.name, node_rel, node_lstat, node_stat)
 
 	# NOTE: Make sure to remove the canonical (real) path of the directory
 	# from the ancestors memo once we are done with it. This allows the
@@ -222,7 +262,49 @@
 	del memodir_real
 
 
-def lookup_pattern(name):
+def iter_tree_files(
+	root: StrPath,
+	on_error: OptionalCallable = None,
+	follow_links: Optionalbool = None,
+) -> Iteratorstr:
+	"""
+	Walks the specified directory for all files.
+
+	*root* (:class:`str` or :class:`os.PathLikestr`) is the root directory to
+	search for files.
+
+	*on_error* (:class:`~collections.abc.Callable` or :data:`None`)
+	optionally is the error handler for file-system exceptions. It will be
+	called with the exception (:exc:`OSError`). Reraise the exception to
+	abort the walk. Default is :data:`None` to ignore file-system
+	exceptions.
+
+	*follow_links* (:class:`bool` or :data:`None`) optionally is whether
+	to walk symbolic links that resolve to directories. Default is
+	:data:`None` for :data:`True`.
+
+	Raises :exc:`RecursionError` if recursion is detected.
+
+	Returns an :class:`~collections.abc.Iterator` yielding the path to
+	each file (:class:`str`) relative to *root*.
+	"""
+	for entry in iter_tree_entries(root, on_error=on_error, follow_links=follow_links):
+		if not entry.is_dir(follow_links):
+			yield entry.path
+
+
+def iter_tree(root, on_error=None, follow_links=None):
+	"""
+	DEPRECATED: The :func:`.iter_tree` function is an alias for the
+	:func:`.iter_tree_files` function.
+	"""
+	warnings.warn((
+		"util.iter_tree() is deprecated. Use util.iter_tree_files() instead."
+	), DeprecationWarning, stacklevel=2)
+	return iter_tree_files(root, on_error=on_error, follow_links=follow_links)
+
+
+def lookup_pattern(name: str) -> CallableAnyStr, Pattern:
 	"""
 	Lookups a registered pattern factory by name.
 
@@ -234,7 +316,7 @@
 	return _registered_patternsname
 
 
-def match_file(patterns, file):
+def match_file(patterns: IterablePattern, file: str) -> bool:
 	"""
 	Matches the file to the patterns.
 
@@ -249,13 +331,20 @@
 	matched = False
 	for pattern in patterns:
 		if pattern.include is not None:
-			if file in pattern.match((file,)):
+			if pattern.match_file(file) is not None:
 				matched = pattern.include
+
 	return matched
 
 
-def match_files(patterns, files):
+def match_files(
+	patterns: IterablePattern,
+	files: Iterablestr,
+) -> Setstr:
 	"""
+	DEPRECATED: This is an old function no longer used. Use the :func:`.match_file`
+	function with a loop for better results.
+
 	Matches the files to the patterns.
 
 	*patterns* (:class:`~collections.abc.Iterable` of :class:`~pathspec.pattern.Pattern`)
@@ -266,50 +355,37 @@
 
 	Returns the matched files (:class:`set` of :class:`str`).
 	"""
-	all_files = files if isinstance(files, Collection) else list(files)
-	return_files = set()
-	for pattern in patterns:
-		if pattern.include is not None:
-			result_files = pattern.match(all_files)
-			if pattern.include:
-				return_files.update(result_files)
-			else:
-				return_files.difference_update(result_files)
-	return return_files
-
+	warnings.warn((
+		"util.match_files() is deprecated. Use util.match_file() with a "
+		"loop for better results."
+	), DeprecationWarning, stacklevel=2)
 
-def _normalize_entries(entries, separators=None):
-	"""
-	Normalizes the entry paths to use the POSIX path separator.
-
-	*entries* (:class:`~collections.abc.Iterable` of :class:`.TreeEntry`)
-	contains the entries to be normalized.
+	use_patterns = _filter_patterns(patterns)
 
-	*separators* (:class:`~collections.abc.Collection` of :class:`str`; or
-	:data:`None`) optionally contains the path separators to normalize.
-	See :func:`normalize_file` for more information.
+	return_files = set()
+	for file in files:
+		if match_file(use_patterns, file):
+			return_files.add(file)
 
-	Returns a :class:`dict` mapping the each normalized file path (:class:`str`)
-	to the entry (:class:`.TreeEntry`)
-	"""
-	norm_files = {}
-	for entry in entries:
-		norm_filesnormalize_file(entry.path, separators=separators) = entry
-	return norm_files
+	return return_files
 
 
-def normalize_file(file, separators=None):
+def normalize_file(
+	file: StrPath,
+	separators: OptionalCollectionstr = None,
+) -> str:
 	"""
-	Normalizes the file path to use the POSIX path separator (i.e., ``'/'``).
+	Normalizes the file path to use the POSIX path separator (i.e.,
+	:data:`'/'`), and make the paths relative (remove leading :data:`'/'`).
 
-	*file* (:class:`str` or :class:`pathlib.PurePath`) is the file path.
+	*file* (:class:`str` or :class:`os.PathLikestr`) is the file path.
 
 	*separators* (:class:`~collections.abc.Collection` of :class:`str`; or
 	:data:`None`) optionally contains the path separators to normalize.
-	This does not need to include the POSIX path separator (``'/'``), but
-	including it will not affect the results. Default is :data:`None` for
-	:data:`NORMALIZE_PATH_SEPS`. To prevent normalization, pass an empty
-	container (e.g., an empty tuple ``()``).
+	This does not need to include the POSIX path separator (:data:`'/'`),
+	but including it will not affect the results. Default is :data:`None`
+	for :data:`NORMALIZE_PATH_SEPS`. To prevent normalization, pass an
+	empty container (e.g., an empty tuple :data:`()`).
 
 	Returns the normalized file path (:class:`str`).
 	"""
@@ -318,39 +394,64 @@
 		separators = NORMALIZE_PATH_SEPS
 
 	# Convert path object to string.
-	norm_file = str(file)
+	norm_file: str = os.fspath(file)
 
 	for sep in separators:
 		norm_file = norm_file.replace(sep, posixpath.sep)
 
-	# Remove current directory prefix.
-	if norm_file.startswith('./'):
+	if norm_file.startswith('/'):
+		# Make path relative.
+		norm_file = norm_file1:
+
+	elif norm_file.startswith('./'):
+		# Remove current directory prefix.
 		norm_file = norm_file2:
 
 	return norm_file
 
 
-def normalize_files(files, separators=None):
+def normalize_files(
+	files: IterableStrPath,
+	separators: OptionalCollectionstr = None,
+) -> Dictstr, ListStrPath:
 	"""
+	DEPRECATED: This function is no longer used. Use the :func:`.normalize_file`
+	function with a loop for better results.
+
 	Normalizes the file paths to use the POSIX path separator.
 
 	*files* (:class:`~collections.abc.Iterable` of :class:`str` or
-	:class:`pathlib.PurePath`) contains the file paths to be normalized.
+	:class:`os.PathLikestr`) contains the file paths to be normalized.
 
 	*separators* (:class:`~collections.abc.Collection` of :class:`str`; or
 	:data:`None`) optionally contains the path separators to normalize.
 	See :func:`normalize_file` for more information.
 
-	Returns a :class:`dict` mapping the each normalized file path (:class:`str`)
-	to the original file path (:class:`str`)
+	Returns a :class:`dict` mapping each normalized file path (:class:`str`)
+	to the original file paths (:class:`list` of :class:`str` or
+	:class:`os.PathLikestr`).
 	"""
+	warnings.warn((
+		"util.normalize_files() is deprecated. Use util.normalize_file() "
+		"with a loop for better results."
+	), DeprecationWarning, stacklevel=2)
+
 	norm_files = {}
 	for path in files:
-		norm_filesnormalize_file(path, separators=separators) = path
+		norm_file = normalize_file(path, separators=separators)
+		if norm_file in norm_files:
+			norm_filesnorm_file.append(path)
+		else:
+			norm_filesnorm_file = path
+
 	return norm_files
 
 
-def register_pattern(name, pattern_factory, override=None):
+def register_pattern(
+	name: str,
+	pattern_factory: CallableAnyStr, Pattern,
+	override: Optionalbool = None,
+) -> None:
 	"""
 	Registers the specified pattern factory.
 
@@ -366,12 +467,15 @@
 	(:data:`True`), instead of raising an :exc:`AlreadyRegisteredError`
 	(:data:`False`). Default is :data:`None` for :data:`False`.
 	"""
-	if not isinstance(name, string_types):
-		raise TypeError("name:{!r} is not a string.".format(name))
+	if not isinstance(name, str):
+		raise TypeError(f"name:{name!r} is not a string.")
+
 	if not callable(pattern_factory):
-		raise TypeError("pattern_factory:{!r} is not callable.".format(pattern_factory))
+		raise TypeError(f"pattern_factory:{pattern_factory!r} is not callable.")
+
 	if name in _registered_patterns and not override:
 		raise AlreadyRegisteredError(name, _registered_patternsname)
+
 	_registered_patternsname = pattern_factory
 
 
@@ -381,7 +485,11 @@
 	factory is registered under a name already in use.
 	"""
 
-	def __init__(self, name, pattern_factory):
+	def __init__(
+		self,
+		name: str,
+		pattern_factory: CallableAnyStr, Pattern,
+	) -> None:
 		"""
 		Initializes the :exc:`AlreadyRegisteredError` instance.
 
@@ -393,7 +501,7 @@
 		super(AlreadyRegisteredError, self).__init__(name, pattern_factory)
 
 	@property
-	def message(self):
+	def message(self) -> str:
 		"""
 		*message* (:class:`str`) is the error message.
 		"""
@@ -403,14 +511,14 @@
 		)
 
 	@property
-	def name(self):
+	def name(self) -> str:
 		"""
 		*name* (:class:`str`) is the name of the registered pattern.
 		"""
 		return self.args0
 
 	@property
-	def pattern_factory(self):
+	def pattern_factory(self) -> CallableAnyStr, Pattern:
 		"""
 		*pattern_factory* (:class:`~collections.abc.Callable`) is the
 		registered pattern factory.
@@ -424,7 +532,12 @@
 	detected.
 	"""
 
-	def __init__(self, real_path, first_path, second_path):
+	def __init__(
+		self,
+		real_path: str,
+		first_path: str,
+		second_path: str,
+	) -> None:
 		"""
 		Initializes the :exc:`RecursionError` instance.
 
@@ -440,7 +553,7 @@
 		super(RecursionError, self).__init__(real_path, first_path, second_path)
 
 	@property
-	def first_path(self):
+	def first_path(self) -> str:
 		"""
 		*first_path* (:class:`str`) is the first path encountered for
 		:attr:`self.real_path <RecursionError.real_path>`.
@@ -448,7 +561,7 @@
 		return self.args1
 
 	@property
-	def message(self):
+	def message(self) -> str:
 		"""
 		*message* (:class:`str`) is the error message.
 		"""
@@ -459,7 +572,7 @@
 		)
 
 	@property
-	def real_path(self):
+	def real_path(self) -> str:
 		"""
 		*real_path* (:class:`str`) is the real path that recursion was
 		encountered on.
@@ -467,7 +580,7 @@
 		return self.args0
 
 	@property
-	def second_path(self):
+	def second_path(self) -> str:
 		"""
 		*second_path* (:class:`str`) is the second path encountered for
 		:attr:`self.real_path <RecursionError.real_path>`.
@@ -480,10 +593,10 @@
 	The :class:`.MatchDetail` class contains information about
 	"""
 
-	#: Make the class dict-less.
+	# Make the class dict-less.
 	__slots__ = ('patterns',)
 
-	def __init__(self, patterns):
+	def __init__(self, patterns: SequencePattern) -> None:
 		"""
 		Initialize the :class:`.MatchDetail` instance.
 
@@ -506,10 +619,16 @@
 	entry.
 	"""
 
-	#: Make the class dict-less.
+	# Make the class dict-less.
 	__slots__ = ('_lstat', 'name', 'path', '_stat')
 
-	def __init__(self, name, path, lstat, stat):
+	def __init__(
+		self,
+		name: str,
+		path: str,
+		lstat: os.stat_result,
+		stat: os.stat_result,
+	) -> None:
 		"""
 		Initialize the :class:`.TreeEntry` instance.
 
@@ -517,36 +636,36 @@
 
 		*path* (:class:`str`) is the relative path of the entry.
 
-		*lstat* (:class:`~os.stat_result`) is the stat result of the direct
+		*lstat* (:class:`os.stat_result`) is the stat result of the direct
 		entry.
 
-		*stat* (:class:`~os.stat_result`) is the stat result of the entry,
+		*stat* (:class:`os.stat_result`) is the stat result of the entry,
 		potentially linked.
 		"""
 
-		self._lstat = lstat
+		self._lstat: os.stat_result = lstat
 		"""
-		*_lstat* (:class:`~os.stat_result`) is the stat result of the direct
+		*_lstat* (:class:`os.stat_result`) is the stat result of the direct
 		entry.
 		"""
 
-		self.name = name
+		self.name: str = name
 		"""
 		*name* (:class:`str`) is the base name of the entry.
 		"""
 
-		self.path = path
+		self.path: str = path
 		"""
 		*path* (:class:`str`) is the path of the entry.
 		"""
 
-		self._stat = stat
+		self._stat: os.stat_result = stat
 		"""
-		*_stat* (:class:`~os.stat_result`) is the stat result of the linked
+		*_stat* (:class:`os.stat_result`) is the stat result of the linked
 		entry.
 		"""
 
-	def is_dir(self, follow_links=None):
+	def is_dir(self, follow_links: Optionalbool = None) -> bool:
 		"""
 		Get whether the entry is a directory.
 
@@ -562,7 +681,7 @@
 		node_stat = self._stat if follow_links else self._lstat
 		return stat.S_ISDIR(node_stat.st_mode)
 
-	def is_file(self, follow_links=None):
+	def is_file(self, follow_links: Optionalbool = None) -> bool:
 		"""
 		Get whether the entry is a regular file.
 
@@ -578,13 +697,13 @@
 		node_stat = self._stat if follow_links else self._lstat
 		return stat.S_ISREG(node_stat.st_mode)
 
-	def is_symlink(self):
+	def is_symlink(self) -> bool:
 		"""
 		Returns whether the entry is a symbolic link (:class:`bool`).
 		"""
 		return stat.S_ISLNK(self._lstat.st_mode)
 
-	def stat(self, follow_links=None):
+	def stat(self, follow_links: Optionalbool = None) -> os.stat_result:
 		"""
 		Get the cached stat result for the entry.
 
@@ -592,7 +711,7 @@
 		symbolic links. If this is :data:`True`, the stat result of the
 		linked file will be returned. Default is :data:`None` for :data:`True`.
 
-		Returns that stat result (:class:`~os.stat_result`).
+		Returns that stat result (:class:`os.stat_result`).
 		"""
 		if follow_links is None:
 			follow_links = True

_service:tar_scm:pathspec-0.11.1.tar.gz/prebuild.py Added

@@ -0,0 +1,84 @@
+"""
+This script generates files required for source and wheel distributions,
+and legacy installations.
+"""
+
+import argparse
+import configparser
+import sys
+
+import tomli
+
+
+def generate_readme_dist() -> None:
+	"""
+	Generate the "README-dist.rst" file from "README.rst" and
+	"CHANGES.rst".
+	"""
+	print("Read: README.rst")
+	with open("README.rst", 'r', encoding='utf8') as fh:
+		output = fh.read()
+
+	print("Read: CHANGES.rst")
+	with open("CHANGES.rst", 'r', encoding='utf8') as fh:
+		output += "\n\n"
+		output += fh.read()
+
+	print("Write: README-dist.rst")
+	with open("README-dist.rst", 'w', encoding='utf8') as fh:
+		fh.write(output)
+
+
+def generate_setup_cfg() -> None:
+	"""
+	Generate the "setup.cfg" file from "pyproject.toml" in order to
+	support legacy installation with "setup.py".
+	"""
+	print("Read: pyproject.toml")
+	with open("pyproject.toml", 'rb') as fh:
+		config = tomli.load(fh)
+
+	print("Write: setup.cfg")
+	output = configparser.ConfigParser()
+	output'metadata' = {
+		'author': config'project''authors'0'name',
+		'author_email': config'project''authors'0'email',
+		'classifiers': "\n" + "\n".join(config'project''classifiers'),
+		'description': config'project''description',
+		'license': config'project''license''text',
+		'long_description': f"file: {config'project''readme'}",
+		'long_description_content_type': "text/x-rst",
+		'name': config'project''name',
+		'url': config'project''urls''Source Code',
+		'version': "attr: pathspec._meta.__version__",
+	}
+	output'options' = {
+		'packages': "find:",
+		'python_requires': config'project''requires-python',
+		'setup_requires': "setuptools>=40.8.0",
+		'test_suite': "tests",
+	}
+	output'options.packages.find' = {
+		'include': "pathspec, pathspec.*",
+	}
+
+	with open("setup.cfg", 'w', encoding='utf8') as fh:
+		output.write(fh)
+
+
+def main() -> int:
+	"""
+	Run the script.
+	"""
+	# Parse command-line arguments.
+	parser = argparse.ArgumentParser(description=__doc__)
+	parser.parse_args(sys.argv1:)
+
+	generate_readme_dist()
+	generate_setup_cfg()
+
+	return 0
+
+
+if __name__ == '__main__':
+	sys.exit(main())

_service:tar_scm:pathspec-0.11.1.tar.gz/pyproject.toml Added

@@ -0,0 +1,52 @@
+build-system
+build-backend = "flit_core.buildapi"
+requires = "flit_core >=3.2,<4"
+
+project
+authors = 
+	{name = "Caleb P. Burns", email = "cpburnz@gmail.com"},
+
+classifiers = 
+	"Development Status :: 4 - Beta",
+	"Intended Audience :: Developers",
+	"License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)",
+	"Operating System :: OS Independent",
+	"Programming Language :: Python",
+	"Programming Language :: Python :: 3",
+	"Programming Language :: Python :: 3.7",
+	"Programming Language :: Python :: 3.8",
+	"Programming Language :: Python :: 3.9",
+	"Programming Language :: Python :: 3.10",
+	"Programming Language :: Python :: 3.11",
+	"Programming Language :: Python :: Implementation :: CPython",
+	"Programming Language :: Python :: Implementation :: PyPy",
+	"Topic :: Software Development :: Libraries :: Python Modules",
+	"Topic :: Utilities",
+
+description = "Utility library for gitignore style pattern matching of file paths."
+dynamic = "version"
+license = {text = "MPL 2.0"}
+name = "pathspec"
+readme = "README-dist.rst"
+requires-python = ">=3.7"
+
+project.urls
+"Source Code" = "https://github.com/cpburnz/python-pathspec"
+"Documentation" = "https://python-path-specification.readthedocs.io/en/latest/index.html"
+"Issue Tracker" = "https://github.com/cpburnz/python-pathspec/issues"
+
+
+tool.flit.sdist
+include = 
+	"*.cfg",
+	"*.in",
+	"*.ini",
+	"*.py",
+	"*.rst",
+	"LICENSE",
+	"doc/",
+	"tests/",
+
+exclude = 
+	"doc/build/",
+

_service:tar_scm:pathspec-0.8.1.tar.gz/setup.cfg -> _service:tar_scm:pathspec-0.11.1.tar.gz/setup.cfg Changed

@@ -1,7 +1,36 @@
-bdist_wheel
-universal = 1
+metadata
+author = Caleb P. Burns
+author_email = cpburnz@gmail.com
+classifiers = 
+	Development Status :: 4 - Beta
+	Intended Audience :: Developers
+	License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
+	Operating System :: OS Independent
+	Programming Language :: Python
+	Programming Language :: Python :: 3
+	Programming Language :: Python :: 3.7
+	Programming Language :: Python :: 3.8
+	Programming Language :: Python :: 3.9
+	Programming Language :: Python :: 3.10
+	Programming Language :: Python :: 3.11
+	Programming Language :: Python :: Implementation :: CPython
+	Programming Language :: Python :: Implementation :: PyPy
+	Topic :: Software Development :: Libraries :: Python Modules
+	Topic :: Utilities
+description = Utility library for gitignore style pattern matching of file paths.
+license = MPL 2.0
+long_description = file: README-dist.rst
+long_description_content_type = text/x-rst
+name = pathspec
+url = https://github.com/cpburnz/python-pathspec
+version = attr: pathspec._meta.__version__
 
-egg_info
-tag_build = 
-tag_date = 0
+options
+packages = find:
+python_requires = >=3.7
+setup_requires = setuptools>=40.8.0
+test_suite = tests
+
+options.packages.find
+include = pathspec, pathspec.*

_service:tar_scm:pathspec-0.8.1.tar.gz/setup.py -> _service:tar_scm:pathspec-0.11.1.tar.gz/setup.py Changed

@@ -1,44 +1,8 @@
-# encoding: utf-8
+"""
+This setup script only exists to support legacy installations where pip
+is cumbersome be used such as for system packages.
+"""
 
-import io
-from setuptools import setup, find_packages
+from setuptools import setup
 
-from pathspec import __author__, __email__, __license__, __project__, __version__
-
-# Read readme and changes files.
-with io.open("README.rst", mode='r', encoding='UTF-8') as fh:
-	readme = fh.read().strip()
-with io.open("CHANGES.rst", mode='r', encoding='UTF-8') as fh:
-	changes = fh.read().strip()
-
-setup(
-	name=__project__,
-	version=__version__,
-	author=__author__,
-	author_email=__email__,
-	url="https://github.com/cpburnz/python-path-specification",
-	description="Utility library for gitignore style pattern matching of file paths.",
-	long_description=readme + "\n\n" + changes,
-	python_requires=">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*",
-	classifiers=
-		"Development Status :: 4 - Beta",
-		"Intended Audience :: Developers",
-		"License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)",
-		"Operating System :: OS Independent",
-		"Programming Language :: Python",
-		"Programming Language :: Python :: 2",
-		"Programming Language :: Python :: 2.7",
-		"Programming Language :: Python :: 3",
-		"Programming Language :: Python :: 3.5",
-		"Programming Language :: Python :: 3.6",
-		"Programming Language :: Python :: 3.7",
-		"Programming Language :: Python :: 3.8",
-		"Programming Language :: Python :: Implementation :: CPython",
-		"Programming Language :: Python :: Implementation :: PyPy",
-		"Topic :: Software Development :: Libraries :: Python Modules",
-		"Topic :: Utilities",
-	,
-	license=__license__,
-	packages=find_packages(),
-	test_suite='pathspec.tests',
-)
+setup()

_service:tar_scm:pathspec-0.11.1.tar.gz/tests/__init__.py Added

_service:tar_scm:pathspec-0.11.1.tar.gz/tests/test_gitignore.py Added

@@ -0,0 +1,390 @@
+"""
+This script tests :class:`.GitIgnoreSpec`.
+"""
+
+import unittest
+
+from pathspec.gitignore import (
+	GitIgnoreSpec)
+
+
+class GitIgnoreSpecTest(unittest.TestCase):
+	"""
+	The :class:`GitIgnoreSpecTest` class tests the :class:`.GitIgnoreSpec`
+	class.
+	"""
+
+	def test_01_reversed_args(self):
+		"""
+		Test reversed args for `.from_lines()`.
+		"""
+		spec = GitIgnoreSpec.from_lines('gitwildmatch', '*.txt')
+		results = set(spec.match_files(
+			'a.txt',
+			'b.bin',
+		))
+		self.assertEqual(results, {
+			'a.txt',
+		})
+
+	def test_02_dir_exclusions(self):
+		"""
+		Test directory exclusions.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			'*.txt',
+			'!test1/',
+		)
+		files = {
+			'test1/a.txt',
+			'test1/b.bin',
+			'test1/c/c.txt',
+			'test2/a.txt',
+			'test2/b.bin',
+			'test2/c/c.txt',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'test1/a.txt',
+			'test1/c/c.txt',
+			'test2/a.txt',
+			'test2/c/c.txt',
+		})
+		self.assertEqual(files - ignores, {
+			'test1/b.bin',
+			'test2/b.bin',
+		})
+
+	def test_02_file_exclusions(self):
+		"""
+		Test file exclusions.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			'*.txt',
+			'!b.txt',
+		)
+		files = {
+			'X/a.txt',
+			'X/b.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/b.txt',
+			'Y/Z/c.txt',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'X/a.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/Z/c.txt',
+		})
+		self.assertEqual(files - ignores, {
+			'X/b.txt',
+			'Y/b.txt',
+		})
+
+	def test_02_issue_41_a(self):
+		"""
+		Test including a file and excluding a directory with the same name
+		pattern, scenario A.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			'*.yaml',
+			'!*.yaml/',
+		)
+		files = {
+			'dir.yaml/file.sql',
+			'dir.yaml/file.yaml',
+			'dir.yaml/index.txt',
+			'dir/file.sql',
+			'dir/file.yaml',
+			'dir/index.txt',
+			'file.yaml',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'dir.yaml/file.yaml',
+			'dir/file.yaml',
+			'file.yaml',
+		})
+		self.assertEqual(files - ignores, {
+			'dir.yaml/file.sql',
+			'dir.yaml/index.txt',
+			'dir/file.sql',
+			'dir/index.txt',
+		})
+
+	def test_02_issue_41_b(self):
+		"""
+		Test including a file and excluding a directory with the same name
+		pattern, scenario B.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			'!*.yaml/',
+			'*.yaml',
+		)
+		files = {
+			'dir.yaml/file.sql',
+			'dir.yaml/file.yaml',
+			'dir.yaml/index.txt',
+			'dir/file.sql',
+			'dir/file.yaml',
+			'dir/index.txt',
+			'file.yaml',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'dir.yaml/file.sql',
+			'dir.yaml/file.yaml',
+			'dir.yaml/index.txt',
+			'dir/file.yaml',
+			'file.yaml',
+		})
+		self.assertEqual(files - ignores, {
+			'dir/file.sql',
+			'dir/index.txt',
+		})
+
+	def test_02_issue_41_c(self):
+		"""
+		Test including a file and excluding a directory with the same name
+		pattern, scenario C.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			'*.yaml',
+			'!dir.yaml',
+		)
+		files = {
+			'dir.yaml/file.sql',
+			'dir.yaml/file.yaml',
+			'dir.yaml/index.txt',
+			'dir/file.sql',
+			'dir/file.yaml',
+			'dir/index.txt',
+			'file.yaml',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'dir.yaml/file.yaml',
+			'dir/file.yaml',
+			'file.yaml',
+		})
+		self.assertEqual(files - ignores, {
+			'dir.yaml/file.sql',
+			'dir.yaml/index.txt',
+			'dir/file.sql',
+			'dir/index.txt',
+		})
+
+	def test_03_subdir(self):
+		"""
+		Test matching files in a subdirectory of an included directory.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			"dirG/",
+		)
+		files = {
+			'fileA',
+			'fileB',
+			'dirD/fileE',
+			'dirD/fileF',
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		})
+		self.assertEqual(files - ignores, {
+			'fileA',
+			'fileB',
+			'dirD/fileE',
+			'dirD/fileF',
+		})
+
+	def test_03_issue_19_a(self):
+		"""
+		Test matching files in a subdirectory of an included directory,
+		scenario A.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			"dirG/",
+		)
+		files = {
+			'fileA',
+			'fileB',
+			'dirD/fileE',
+			'dirD/fileF',
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		})
+		self.assertEqual(files - ignores, {
+			'fileA',
+			'fileB',
+			'dirD/fileE',
+			'dirD/fileF',
+		})
+
+	def test_03_issue_19_b(self):
+		"""
+		Test matching files in a subdirectory of an included directory,
+		scenario B.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			"dirG/*",
+		)
+		files = {
+			'fileA',
+			'fileB',
+			'dirD/fileE',
+			'dirD/fileF',
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		})
+		self.assertEqual(files - ignores, {
+			'fileA',
+			'fileB',
+			'dirD/fileE',
+			'dirD/fileF',
+		})
+
+	def test_03_issue_19_c(self):
+		"""
+		Test matching files in a subdirectory of an included directory,
+		scenario C.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			"dirG/**",
+		)
+		files = {
+			'fileA',
+			'fileB',
+			'dirD/fileE',
+			'dirD/fileF',
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		})
+		self.assertEqual(files - ignores, {
+			'fileA',
+			'fileB',
+			'dirD/fileE',
+			'dirD/fileF',
+		})
+
+	def test_04_issue_62(self):
+		"""
+		Test including all files and excluding a directory.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			'*',
+			'!product_dir/',
+		)
+		results = set(spec.match_files(
+			'anydir/file.txt',
+			'product_dir/file.txt',
+		))
+		self.assertEqual(results, {
+			'anydir/file.txt',
+			'product_dir/file.txt',
+		})
+
+	def test_05_issue_39(self):
+		"""
+		Test excluding files in a directory.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			'*.log',
+			'!important/*.log',
+			'trace.*',
+		)
+		files = {
+			'a.log',
+			'b.txt',
+			'important/d.log',
+			'important/e.txt',
+			'trace.c',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'a.log',
+			'trace.c',
+		})
+		self.assertEqual(files - ignores, {
+			'b.txt',
+			'important/d.log',
+			'important/e.txt',
+		})
+
+	def test_06_issue_64(self):
+		"""
+		Test using a double asterisk pattern.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			"**",
+		)
+		files = {
+			'x',
+			'y.py',
+			'A/x',
+			'A/y.py',
+			'A/B/x',
+			'A/B/y.py',
+			'A/B/C/x',
+			'A/B/C/y.py',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, files)
+
+	def test_07_issue_74(self):
+		"""
+		Test include directory should override exclude file.
+		"""
+		spec = GitIgnoreSpec.from_lines(
+			'*',  # Ignore all files by default
+			'!*/',  # but scan all directories
+			'!*.txt',  # Text files
+			'/test1/**',  # ignore all in the directory
+		)
+		files = {
+			'test1/b.bin',
+			'test1/a.txt',
+			'test1/c/c.txt',
+			'test2/a.txt',
+			'test2/b.bin',
+			'test2/c/c.txt',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'test1/b.bin',
+			'test1/a.txt',
+			'test1/c/c.txt',
+			'test2/b.bin',
+		})
+		self.assertEqual(files - ignores, {
+			'test2/a.txt',
+			'test2/c/c.txt',
+		})

_service:tar_scm:pathspec-0.11.1.tar.gz/tests/test_gitwildmatch.py Added

@@ -0,0 +1,775 @@
+"""
+This script tests :class:`.GitWildMatchPattern`.
+"""
+
+import re
+import unittest
+
+import pathspec.patterns.gitwildmatch
+from pathspec.patterns.gitwildmatch import (
+	GitWildMatchPattern,
+	GitWildMatchPatternError,
+	_BYTES_ENCODING,
+	_DIR_MARK)
+from pathspec.util import (
+	lookup_pattern)
+
+
+RE_DIR = f"(?P<{_DIR_MARK}>/)"
+"""
+This regular expression matches the directory marker.
+"""
+
+RE_SUB = f"(?:{RE_DIR}.*)?"
+"""
+This regular expression matches an optional sub-path.
+"""
+
+
+class GitWildMatchTest(unittest.TestCase):
+	"""
+	The :class:`GitWildMatchTest` class tests the :class:`GitWildMatchPattern`
+	implementation.
+	"""
+
+	def _check_invalid_pattern(self, git_ignore_pattern):
+		expected_message_pattern = re.escape(repr(git_ignore_pattern))
+		with self.assertRaisesRegex(GitWildMatchPatternError, expected_message_pattern):
+			GitWildMatchPattern(git_ignore_pattern)
+
+	def test_00_empty(self):
+		"""
+		Tests an empty pattern.
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('')
+		self.assertIsNone(include)
+		self.assertIsNone(regex)
+
+	def test_01_absolute(self):
+		"""
+		Tests an absolute path pattern.
+
+		This should match:
+
+			an/absolute/file/path
+			an/absolute/file/path/foo
+
+		This should NOT match:
+
+			foo/an/absolute/file/path
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('/an/absolute/file/path')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^an/absolute/file/path{RE_SUB}$')
+
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'an/absolute/file/path',
+			'an/absolute/file/path/foo',
+			'foo/an/absolute/file/path',
+		))
+		self.assertEqual(results, {
+			'an/absolute/file/path',
+			'an/absolute/file/path/foo',
+		})
+
+	def test_01_absolute_ignore(self):
+		"""
+		Tests an ignore absolute path pattern.
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('!/foo/build')
+		self.assertFalse(include)
+		self.assertEqual(regex, f'^foo/build{RE_SUB}$')
+
+		# NOTE: The pattern match is backwards because the pattern itself
+		# does not consider the include attribute.
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'build/file.py',
+			'foo/build/file.py',
+		))
+		self.assertEqual(results, {
+			'foo/build/file.py',
+		})
+
+	def test_01_absolute_root(self):
+		"""
+		Tests a single root absolute path pattern.
+
+		This should NOT match any file (according to git check-ignore
+		(v2.4.1)).
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('/')
+		self.assertIsNone(include)
+		self.assertIsNone(regex)
+
+	def test_01_relative(self):
+		"""
+		Tests a relative path pattern.
+
+		This should match:
+
+			spam
+			spam/
+			foo/spam
+			spam/foo
+			foo/spam/bar
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('spam')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^(?:.+/)?spam{RE_SUB}$')
+
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'spam',
+			'spam/',
+			'foo/spam',
+			'spam/foo',
+			'foo/spam/bar',
+		))
+		self.assertEqual(results, {
+			'spam',
+			'spam/',
+			'foo/spam',
+			'spam/foo',
+			'foo/spam/bar',
+		})
+
+	def test_01_relative_nested(self):
+		"""
+		Tests a relative nested path pattern.
+
+		This should match:
+
+			foo/spam
+			foo/spam/bar
+
+		This should **not** match (according to git check-ignore (v2.4.1)):
+
+			bar/foo/spam
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('foo/spam')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^foo/spam{RE_SUB}$')
+
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'foo/spam',
+			'foo/spam/bar',
+			'bar/foo/spam',
+		))
+		self.assertEqual(results, {
+			'foo/spam',
+			'foo/spam/bar',
+		})
+
+	def test_02_comment(self):
+		"""
+		Tests a comment pattern.
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('# Cork soakers.')
+		self.assertIsNone(include)
+		self.assertIsNone(regex)
+
+	def test_02_ignore(self):
+		"""
+		Tests an exclude pattern.
+
+		This should NOT match (according to git check-ignore (v2.4.1)):
+
+			temp/foo
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('!temp')
+		self.assertIsNotNone(include)
+		self.assertFalse(include)
+		self.assertEqual(regex, f'^(?:.+/)?temp{RE_SUB}$')
+
+		# NOTE: The pattern match is backwards because the pattern itself
+		# does not consider the include attribute.
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'temp/foo',
+		))
+		self.assertEqual(results, {
+			'temp/foo',
+		})
+
+	def test_03_child_double_asterisk(self):
+		"""
+		Tests a directory name with a double-asterisk child
+		directory.
+
+		This should match:
+
+			spam/bar
+
+		This should **not** match (according to git check-ignore (v2.4.1)):
+
+			foo/spam/bar
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('spam/**')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^spam{RE_DIR}.*$')
+
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'spam/bar',
+			'foo/spam/bar',
+		))
+		self.assertEqual(results, {'spam/bar'})
+
+	def test_03_inner_double_asterisk(self):
+		"""
+		Tests a path with an inner double-asterisk directory.
+
+		This should match:
+
+			left/right
+			left/bar/right
+			left/foo/bar/right
+			left/bar/right/foo
+
+		This should **not** match (according to git check-ignore (v2.4.1)):
+
+			foo/left/bar/right
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('left/**/right')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^left(?:/.+)?/right{RE_SUB}$')
+
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'left/right',
+			'left/bar/right',
+			'left/foo/bar/right',
+			'left/bar/right/foo',
+			'foo/left/bar/right',
+		))
+		self.assertEqual(results, {
+			'left/right',
+			'left/bar/right',
+			'left/foo/bar/right',
+			'left/bar/right/foo',
+		})
+
+	def test_03_only_double_asterisk(self):
+		"""
+		Tests a double-asterisk pattern which matches everything.
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('**')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^^/+{RE_SUB}$')
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'x',
+			'y.py',
+			'A/x',
+			'A/y.py',
+			'A/B/x',
+			'A/B/y.py',
+			'A/B/C/x',
+			'A/B/C/y.py',
+		))
+
+		self.assertEqual(results, {
+			'x',
+			'y.py',
+			'A/x',
+			'A/y.py',
+			'A/B/x',
+			'A/B/y.py',
+			'A/B/C/x',
+			'A/B/C/y.py',
+		})
+
+	def test_03_parent_double_asterisk(self):
+		"""
+		Tests a file name with a double-asterisk parent directory.
+
+		This should match:
+
+			spam
+			foo/spam
+			foo/spam/bar
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('**/spam')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^(?:.+/)?spam{RE_SUB}$')
+
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'spam',
+			'foo/spam',
+			'foo/spam/bar',
+		))
+		self.assertEqual(results, {
+			'spam',
+			'foo/spam',
+			'foo/spam/bar',
+		})
+
+	def test_03_duplicate_leading_double_asterisk_edge_case(self):
+		"""
+		Regression test for duplicate leading **/ bug.
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('**')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^^/+{RE_SUB}$')
+
+		equivalent_regex, include = GitWildMatchPattern.pattern_to_regex('**/**')
+		self.assertTrue(include)
+		self.assertEqual(equivalent_regex, regex)
+
+		equivalent_regex, include = GitWildMatchPattern.pattern_to_regex('**/**/**')
+		self.assertTrue(include)
+		self.assertEqual(equivalent_regex, regex)
+
+		regex, include = GitWildMatchPattern.pattern_to_regex('**/api')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^(?:.+/)?api{RE_SUB}$')
+
+		equivalent_regex, include = GitWildMatchPattern.pattern_to_regex(f'**/**/api')
+		self.assertTrue(include)
+		self.assertEqual(equivalent_regex, regex)
+
+		regex, include = GitWildMatchPattern.pattern_to_regex('**/api/')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^(?:.+/)?api{RE_DIR}.*$')
+
+		equivalent_regex, include = GitWildMatchPattern.pattern_to_regex('**/api/**')
+		self.assertTrue(include)
+		self.assertEqual(equivalent_regex, regex)
+
+		equivalent_regex, include = GitWildMatchPattern.pattern_to_regex('**/**/api/**/**')
+		self.assertTrue(include)
+		self.assertEqual(equivalent_regex, regex)
+
+	def test_03_double_asterisk_trailing_slash_edge_case(self):
+		"""
+		Tests the edge-case **/ pattern.
+
+		This should match everything except individual files in the root directory.
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('**/')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^.+{RE_DIR}.*$')
+
+		equivalent_regex, include = GitWildMatchPattern.pattern_to_regex('**/**/')
+		self.assertTrue(include)
+		self.assertEqual(equivalent_regex, regex)
+
+	def test_04_infix_wildcard(self):
+		"""
+		Tests a pattern with an infix wildcard.
+
+		This should match:
+
+			foo--bar
+			foo-hello-bar
+			a/foo-hello-bar
+			foo-hello-bar/b
+			a/foo-hello-bar/b
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('foo-*-bar')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^(?:.+/)?foo\\-^/*\\-bar{RE_SUB}$')
+
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'foo--bar',
+			'foo-hello-bar',
+			'a/foo-hello-bar',
+			'foo-hello-bar/b',
+			'a/foo-hello-bar/b',
+		))
+		self.assertEqual(results, {
+			'foo--bar',
+			'foo-hello-bar',
+			'a/foo-hello-bar',
+			'foo-hello-bar/b',
+			'a/foo-hello-bar/b',
+		})
+
+	def test_04_postfix_wildcard(self):
+		"""
+		Tests a pattern with a postfix wildcard.
+
+		This should match:
+
+			~temp-
+			~temp-foo
+			~temp-foo/bar
+			foo/~temp-bar
+			foo/~temp-bar/baz
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('~temp-*')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^(?:.+/)?\\~temp\\-^/*{RE_SUB}$')
+
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'~temp-',
+			'~temp-foo',
+			'~temp-foo/bar',
+			'foo/~temp-bar',
+			'foo/~temp-bar/baz',
+		))
+		self.assertEqual(results, {
+			'~temp-',
+			'~temp-foo',
+			'~temp-foo/bar',
+			'foo/~temp-bar',
+			'foo/~temp-bar/baz',
+		})
+
+	def test_04_prefix_wildcard(self):
+		"""
+		Tests a pattern with a prefix wildcard.
+
+		This should match:
+
+			bar.py
+			bar.py/
+			foo/bar.py
+			foo/bar.py/baz
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('*.py')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^(?:.+/)?^/*\\.py{RE_SUB}$')
+
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'bar.py',
+			'bar.py/',
+			'foo/bar.py',
+			'foo/bar.py/baz',
+		))
+		self.assertEqual(results, {
+			'bar.py',
+			'bar.py/',
+			'foo/bar.py',
+			'foo/bar.py/baz',
+		})
+
+	def test_05_directory(self):
+		"""
+		Tests a directory pattern.
+
+		This should match:
+
+			dir/
+			foo/dir/
+			foo/dir/bar
+
+		This should **not** match:
+
+			dir
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('dir/')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^(?:.+/)?dir{RE_DIR}.*$')
+
+		pattern = GitWildMatchPattern(re.compile(regex), include)
+		results = set(filter(pattern.match_file, 
+			'dir/',
+			'foo/dir/',
+			'foo/dir/bar',
+			'dir',
+		))
+		self.assertEqual(results, {
+			'dir/',
+			'foo/dir/',
+			'foo/dir/bar',
+		})
+
+	def test_06_registered(self):
+		"""
+		Tests that the pattern is registered.
+		"""
+		self.assertIs(lookup_pattern('gitwildmatch'), GitWildMatchPattern)
+
+	def test_06_access_deprecated(self):
+		"""
+		Tests that the pattern is accessible from the root module using the
+		deprecated alias.
+		"""
+		self.assertTrue(hasattr(pathspec, 'GitIgnorePattern'))
+		self.assertTrue(issubclass(pathspec.GitIgnorePattern, GitWildMatchPattern))
+
+	def test_06_registered_deprecated(self):
+		"""
+		Tests that the pattern is registered under the deprecated alias.
+		"""
+		self.assertIs(lookup_pattern('gitignore'), pathspec.GitIgnorePattern)
+
+	def test_07_encode_bytes(self):
+		"""
+		Test encoding bytes.
+		"""
+		encoded = "".join(map(chr, range(0, 256))).encode(_BYTES_ENCODING)
+		expected = (
+			b"\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f\x10"
+			b"\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f"
+			b" !\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ\\"
+			b"^_`abcdefghijklmnopqrstuvwxyz{|}~"
+			b"\x7f\x80\x81\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x8b\x8c\x8d"
+			b"\x8e\x8f\x90\x91\x92\x93\x94\x95\x96\x97\x98\x99\x9a\x9b\x9c"
+			b"\x9d\x9e\x9f\xa0\xa1\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xab"
+			b"\xac\xad\xae\xaf\xb0\xb1\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba"
+			b"\xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9"
+			b"\xca\xcb\xcc\xcd\xce\xcf\xd0\xd1\xd2\xd3\xd4\xd5\xd6\xd7\xd8"
+			b"\xd9\xda\xdb\xdc\xdd\xde\xdf\xe0\xe1\xe2\xe3\xe4\xe5\xe6\xe7"
+			b"\xe8\xe9\xea\xeb\xec\xed\xee\xef\xf0\xf1\xf2\xf3\xf4\xf5\xf6"
+			b"\xf7\xf8\xf9\xfa\xfb\xfc\xfd\xfe\xff"
+		)
+		self.assertEqual(encoded, expected)
+
+	def test_07_decode_bytes(self):
+		"""
+		Test decoding bytes.
+		"""
+		decoded = bytes(bytearray(range(0, 256))).decode(_BYTES_ENCODING)
+		expected = (
+			"\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f\x10"
+			"\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f"
+			" !\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ\\"
+			"^_`abcdefghijklmnopqrstuvwxyz{|}~"
+			"\x7f\x80\x81\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x8b\x8c\x8d"
+			"\x8e\x8f\x90\x91\x92\x93\x94\x95\x96\x97\x98\x99\x9a\x9b\x9c"
+			"\x9d\x9e\x9f\xa0\xa1\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xab"
+			"\xac\xad\xae\xaf\xb0\xb1\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba"
+			"\xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9"
+			"\xca\xcb\xcc\xcd\xce\xcf\xd0\xd1\xd2\xd3\xd4\xd5\xd6\xd7\xd8"
+			"\xd9\xda\xdb\xdc\xdd\xde\xdf\xe0\xe1\xe2\xe3\xe4\xe5\xe6\xe7"
+			"\xe8\xe9\xea\xeb\xec\xed\xee\xef\xf0\xf1\xf2\xf3\xf4\xf5\xf6"
+			"\xf7\xf8\xf9\xfa\xfb\xfc\xfd\xfe\xff"
+		)
+		self.assertEqual(decoded, expected)
+
+	def test_07_match_bytes_and_bytes(self):
+		"""
+		Test byte string patterns matching byte string paths.
+		"""
+		pattern = GitWildMatchPattern(b'*.py')
+		results = set(filter(pattern.match_file, b'a.py'))
+		self.assertEqual(results, {b'a.py'})
+
+	def test_07_match_bytes_and_bytes_complete(self):
+		"""
+		Test byte string patterns matching byte string paths.
+		"""
+		encoded = bytes(bytearray(range(0, 256)))
+
+		# Forward slashes cannot be escaped with the current implementation.
+		# Remove ASCII 47.
+		fs_ord = ord('/')
+		encoded = encoded:fs_ord + encodedfs_ord+1:
+
+		escaped = b"".join(b"\\" + encodedi:i+1 for i in range(len(encoded)))
+
+		pattern = GitWildMatchPattern(escaped)
+		results = set(filter(pattern.match_file, encoded))
+		self.assertEqual(results, {encoded})
+
+	def test_07_match_bytes_and_unicode_fail(self):
+		"""
+		Test byte string patterns matching byte string paths.
+		"""
+		pattern = GitWildMatchPattern(b'*.py')
+		with self.assertRaises(TypeError):
+			pattern.match_file('a.py')
+
+	def test_07_match_unicode_and_bytes_fail(self):
+		"""
+		Test unicode patterns with byte paths.
+		"""
+		pattern = GitWildMatchPattern('*.py')
+		with self.assertRaises(TypeError):
+			pattern.match_file(b'a.py')
+
+	def test_07_match_unicode_and_unicode(self):
+		"""
+		Test unicode patterns with unicode paths.
+		"""
+		pattern = GitWildMatchPattern('*.py')
+		results = set(filter(pattern.match_file, 'a.py'))
+		self.assertEqual(results, {'a.py'})
+
+	def test_08_escape(self):
+		"""
+		Test escaping a string with meta-characters
+		"""
+		fname = "file!with*weird#naming_1.t?t"
+		escaped = r"file\!with\*weird\#naming_\1\.t\?t"
+		result = GitWildMatchPattern.escape(fname)
+		self.assertEqual(result, escaped)
+
+	def test_09_single_escape_fail(self):
+		"""
+		Test an escape on a line by itself.
+		"""
+		self._check_invalid_pattern("\\")
+
+	def test_09_single_exclamation_mark_fail(self):
+		"""
+		Test an escape on a line by itself.
+		"""
+		self._check_invalid_pattern("!")
+
+	def test_10_escape_asterisk_end(self):
+		"""
+		Test escaping an asterisk at the end of a line.
+		"""
+		pattern = GitWildMatchPattern("asteris\\*")
+		results = set(filter(pattern.match_file, 
+			"asteris*",
+			"asterisk",
+		))
+		self.assertEqual(results, {"asteris*"})
+
+	def test_10_escape_asterisk_mid(self):
+		"""
+		Test escaping an asterisk in the middle of a line.
+		"""
+		pattern = GitWildMatchPattern("as\\*erisk")
+		results = set(filter(pattern.match_file, 
+			"as*erisk",
+			"asterisk",
+		))
+		self.assertEqual(results, {"as*erisk"})
+
+	def test_10_escape_asterisk_start(self):
+		"""
+		Test escaping an asterisk at the start of a line.
+		"""
+		pattern = GitWildMatchPattern("\\*sterisk")
+		results = set(filter(pattern.match_file, 
+			"*sterisk",
+			"asterisk",
+		))
+		self.assertEqual(results, {"*sterisk"})
+
+	def test_10_escape_exclamation_mark_start(self):
+		"""
+		Test escaping an exclamation mark at the start of a line.
+		"""
+		pattern = GitWildMatchPattern("\\!mark")
+		results = set(filter(pattern.match_file, 
+			"!mark",
+		))
+		self.assertEqual(results, {"!mark"})
+
+	def test_10_escape_pound_start(self):
+		"""
+		Test escaping a pound sign at the start of a line.
+		"""
+		pattern = GitWildMatchPattern("\\#sign")
+		results = set(filter(pattern.match_file, 
+			"#sign",
+		))
+		self.assertEqual(results, {"#sign"})
+
+	def test_11_match_directory_1(self):
+		"""
+		Test matching a directory.
+		"""
+		pattern = GitWildMatchPattern("dirG/")
+		results = set(filter(pattern.match_file, 
+			'fileA',
+			'fileB',
+			'dirD/fileE',
+			'dirD/fileF',
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		))
+		self.assertEqual(results, {
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		})
+
+	def test_11_match_directory_2(self):
+		"""
+		Test matching a directory.
+		"""
+		pattern = GitWildMatchPattern("dirG/*")
+		results = set(filter(pattern.match_file, 
+			'fileA',
+			'fileB',
+			'dirD/fileE',
+			'dirD/fileF',
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		))
+		self.assertEqual(results, {
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		})
+
+	def test_11_match_sub_directory_3(self):
+		"""
+		Test matching a directory.
+		"""
+		pattern = GitWildMatchPattern("dirG/**")
+		results = set(filter(pattern.match_file, 
+			'fileA',
+			'fileB',
+			'dirD/fileE',
+			'dirD/fileF',
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		))
+		self.assertEqual(results, {
+			'dirG/dirH/fileI',
+			'dirG/dirH/fileJ',
+			'dirG/fileO',
+		})
+
+	def test_12_asterisk_1_regex(self):
+		"""
+		Test a relative asterisk path pattern's regular expression.
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('*')
+		self.assertTrue(include)
+		self.assertEqual(regex, f'^(?:.+/)?^/+{RE_SUB}$')
+
+	def test_12_asterisk_2_regex_equivalent(self):
+		"""
+		Test a path pattern equivalent to the relative asterisk using double
+		asterisk.
+		"""
+		regex, include = GitWildMatchPattern.pattern_to_regex('*')
+		self.assertTrue(include)
+
+		equiv_regex, include = GitWildMatchPattern.pattern_to_regex('**/*')
+		self.assertTrue(include)
+
+		self.assertEqual(regex, equiv_regex)
+
+	def test_12_asterisk_3_child(self):
+		"""
+		Test a relative asterisk path pattern matching a direct child path.
+		"""
+		pattern = GitWildMatchPattern('*')
+		results = set(filter(pattern.match_file, 
+			'file.txt',
+		))
+		self.assertEqual(results, {
+			'file.txt',
+		})
+
+	def test_12_asterisk_4_descendant(self):
+		"""
+		Test a relative asterisk path pattern matching a descendant path.
+		"""
+		pattern = GitWildMatchPattern('*')
+		results = set(filter(pattern.match_file, 
+			'anydir/file.txt',
+		))
+		self.assertEqual(results, {
+			'anydir/file.txt',
+		})

_service:tar_scm:pathspec-0.11.1.tar.gz/tests/test_pathspec.py Added

@@ -0,0 +1,554 @@
+"""
+This script tests :class:`.PathSpec`.
+"""
+
+import os
+import os.path
+import pathlib
+import shutil
+import tempfile
+import unittest
+from typing import (
+	Iterable)
+
+from pathspec import (
+	PathSpec)
+from pathspec.util import (
+	iter_tree_entries)
+from tests.util import (
+	make_dirs,
+	make_files,
+	ospath)
+
+
+class PathSpecTest(unittest.TestCase):
+	"""
+	The :class:`PathSpecTest` class tests the :class:`.PathSpec` class.
+	"""
+
+	def make_dirs(self, dirs: Iterablestr) -> None:
+		"""
+		Create the specified directories.
+		"""
+		make_dirs(self.temp_dir, dirs)
+
+	def make_files(self, files: Iterablestr) -> None:
+		"""
+		Create the specified files.
+		"""
+		return make_files(self.temp_dir, files)
+
+	def setUp(self) -> None:
+		"""
+		Called before each test.
+		"""
+		self.temp_dir = pathlib.Path(tempfile.mkdtemp())
+
+	def tearDown(self) -> None:
+		"""
+		Called after each test.
+		"""
+		shutil.rmtree(self.temp_dir)
+
+	def test_01_absolute_dir_paths_1(self):
+		"""
+		Tests that absolute paths will be properly normalized and matched.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'foo',
+		)
+		results = set(spec.match_files(
+			'/a.py',
+			'/foo/a.py',
+			'/x/a.py',
+			'/x/foo/a.py',
+			'a.py',
+			'foo/a.py',
+			'x/a.py',
+			'x/foo/a.py',
+		))
+		self.assertEqual(results, {
+			'/foo/a.py',
+			'/x/foo/a.py',
+			'foo/a.py',
+			'x/foo/a.py',
+		})
+
+	def test_01_absolute_dir_paths_2(self):
+		"""
+		Tests that absolute paths will be properly normalized and matched.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'/foo',
+		)
+		results = set(spec.match_files(
+			'/a.py',
+			'/foo/a.py',
+			'/x/a.py',
+			'/x/foo/a.py',
+			'a.py',
+			'foo/a.py',
+			'x/a.py',
+			'x/foo/a.py',
+		))
+		self.assertEqual(results, {
+			'/foo/a.py',
+			'foo/a.py',
+		})
+
+	def test_01_current_dir_paths(self):
+		"""
+		Tests that paths referencing the current directory will be properly
+		normalized and matched.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+			'!test1/',
+		)
+		results = set(spec.match_files(
+			'./src/test1/a.txt',
+			'./src/test1/b.txt',
+			'./src/test1/c/c.txt',
+			'./src/test2/a.txt',
+			'./src/test2/b.txt',
+			'./src/test2/c/c.txt',
+		))
+		self.assertEqual(results, {
+			'./src/test2/a.txt',
+			'./src/test2/b.txt',
+			'./src/test2/c/c.txt',
+		})
+
+	def test_01_match_files(self):
+		"""
+		Tests that matching files one at a time yields the same results as
+		matching multiples files at once.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+			'!test1/',
+		)
+		test_files = 
+			'src/test1/a.txt',
+			'src/test1/b.txt',
+			'src/test1/c/c.txt',
+			'src/test2/a.txt',
+			'src/test2/b.txt',
+			'src/test2/c/c.txt',
+		
+		single_results = set(filter(spec.match_file, test_files))
+		multi_results = set(spec.match_files(test_files))
+		self.assertEqual(single_results, multi_results)
+
+	def test_01_windows_current_dir_paths(self):
+		"""
+		Tests that paths referencing the current directory will be properly
+		normalized and matched.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+			'!test1/',
+		)
+		results = set(spec.match_files(
+			'.\\src\\test1\\a.txt',
+			'.\\src\\test1\\b.txt',
+			'.\\src\\test1\\c\\c.txt',
+			'.\\src\\test2\\a.txt',
+			'.\\src\\test2\\b.txt',
+			'.\\src\\test2\\c\\c.txt',
+		, separators=('\\',)))
+		self.assertEqual(results, {
+			'.\\src\\test2\\a.txt',
+			'.\\src\\test2\\b.txt',
+			'.\\src\\test2\\c\\c.txt',
+		})
+
+	def test_01_windows_paths(self):
+		"""
+		Tests that Windows paths will be properly normalized and matched.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+			'!test1/',
+		)
+		results = set(spec.match_files(
+			'src\\test1\\a.txt',
+			'src\\test1\\b.txt',
+			'src\\test1\\c\\c.txt',
+			'src\\test2\\a.txt',
+			'src\\test2\\b.txt',
+			'src\\test2\\c\\c.txt',
+		, separators=('\\',)))
+		self.assertEqual(results, {
+			'src\\test2\\a.txt',
+			'src\\test2\\b.txt',
+			'src\\test2\\c\\c.txt',
+		})
+
+	def test_02_eq(self):
+		"""
+		Tests equality.
+		"""
+		first_spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+			'!test1/',
+		)
+		second_spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+			'!test1/',
+		)
+		self.assertEqual(first_spec, second_spec)
+
+	def test_02_ne(self):
+		"""
+		Tests inequality.
+		"""
+		first_spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+		)
+		second_spec = PathSpec.from_lines('gitwildmatch', 
+			'!*.txt',
+		)
+		self.assertNotEqual(first_spec, second_spec)
+
+	def test_03_add(self):
+		"""
+		Test spec addition using :data:`+` operator.
+		"""
+		first_spec = PathSpec.from_lines('gitwildmatch', 
+			'test.txt',
+			'test.png'
+		)
+		second_spec = PathSpec.from_lines('gitwildmatch', 
+			'test.html',
+			'test.jpg'
+		)
+		combined_spec = first_spec + second_spec
+		results = set(combined_spec.match_files(
+			'test.txt',
+			'test.png',
+			'test.html',
+			'test.jpg'
+		))
+		self.assertEqual(results, {
+			'test.txt',
+			'test.png',
+			'test.html',
+			'test.jpg'
+		})
+
+	def test_03_iadd(self):
+		"""
+		Test spec addition using :data:`+=` operator.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'test.txt',
+			'test.png'
+		)
+		spec += PathSpec.from_lines('gitwildmatch', 
+			'test.html',
+			'test.jpg'
+		)
+		results = set(spec.match_files(
+			'test.txt',
+			'test.png',
+			'test.html',
+			'test.jpg'
+		))
+		self.assertEqual(results, {
+			'test.txt',
+			'test.png',
+			'test.html',
+			'test.jpg'
+		})
+
+	def test_04_len(self):
+		"""
+		Test spec length.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'foo',
+			'bar',
+		)
+		self.assertEqual(len(spec), 2)
+
+	def test_05_match_entries(self):
+		"""
+		Test matching files collectively.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+			'!b.txt',
+		)
+		self.make_dirs(
+			'X',
+			'X/Z',
+			'Y',
+			'Y/Z',
+		)
+		self.make_files(
+			'X/a.txt',
+			'X/b.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/b.txt',
+			'Y/Z/c.txt',
+		)
+		entries = iter_tree_entries(self.temp_dir)
+		results = {
+			__entry.path
+			for __entry in spec.match_entries(entries)
+		}
+		self.assertEqual(results, set(map(ospath, 
+			'X/a.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/Z/c.txt',
+		)))
+
+	def test_05_match_file(self):
+		"""
+		Test matching files individually.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+			'!b.txt',
+		)
+		results = set(filter(spec.match_file, 
+			'X/a.txt',
+			'X/b.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/b.txt',
+			'Y/Z/c.txt',
+		))
+		self.assertEqual(results, {
+			'X/a.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/Z/c.txt',
+		})
+
+	def test_05_match_files(self):
+		"""
+		Test matching files collectively.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+			'!b.txt',
+		)
+		results = set(spec.match_files(
+			'X/a.txt',
+			'X/b.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/b.txt',
+			'Y/Z/c.txt',
+		))
+		self.assertEqual(results, {
+			'X/a.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/Z/c.txt',
+		})
+
+	def test_05_match_tree_entries(self):
+		"""
+		Test matching a file tree.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+			'!b.txt',
+		)
+		self.make_dirs(
+			'X',
+			'X/Z',
+			'Y',
+			'Y/Z',
+		)
+		self.make_files(
+			'X/a.txt',
+			'X/b.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/b.txt',
+			'Y/Z/c.txt',
+		)
+		results = {
+			__entry.path
+			for __entry in spec.match_tree_entries(self.temp_dir)
+		}
+		self.assertEqual(results, set(map(ospath, 
+			'X/a.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/Z/c.txt',
+		)))
+
+	def test_05_match_tree_files(self):
+		"""
+		Test matching a file tree.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.txt',
+			'!b.txt',
+		)
+		self.make_dirs(
+			'X',
+			'X/Z',
+			'Y',
+			'Y/Z',
+		)
+		self.make_files(
+			'X/a.txt',
+			'X/b.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/b.txt',
+			'Y/Z/c.txt',
+		)
+		results = set(spec.match_tree_files(self.temp_dir))
+		self.assertEqual(results, set(map(ospath, 
+			'X/a.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/Z/c.txt',
+		)))
+
+	def test_06_issue_41_a(self):
+		"""
+		Test including a file and excluding a directory with the same name
+		pattern, scenario A.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.yaml',
+			'!*.yaml/',
+		)
+		files = {
+			'dir.yaml/file.sql',
+			'dir.yaml/file.yaml',
+			'dir.yaml/index.txt',
+			'dir/file.sql',
+			'dir/file.yaml',
+			'dir/index.txt',
+			'file.yaml',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			#'dir.yaml/file.yaml',  # Discrepancy with Git.
+			'dir/file.yaml',
+			'file.yaml',
+		})
+		self.assertEqual(files - ignores, {
+			'dir.yaml/file.sql',
+			'dir.yaml/file.yaml',  # Discrepancy with Git.
+			'dir.yaml/index.txt',
+			'dir/file.sql',
+			'dir/index.txt',
+		})
+
+	def test_06_issue_41_b(self):
+		"""
+		Test including a file and excluding a directory with the same name
+		pattern, scenario B.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'!*.yaml/',
+			'*.yaml',
+		)
+		files = {
+			'dir.yaml/file.sql',
+			'dir.yaml/file.yaml',
+			'dir.yaml/index.txt',
+			'dir/file.sql',
+			'dir/file.yaml',
+			'dir/index.txt',
+			'file.yaml',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'dir.yaml/file.sql',
+			'dir.yaml/file.yaml',
+			'dir.yaml/index.txt',
+			'dir/file.yaml',
+			'file.yaml',
+		})
+		self.assertEqual(files - ignores, {
+			'dir/file.sql',
+			'dir/index.txt',
+		})
+
+	def test_06_issue_41_c(self):
+		"""
+		Test including a file and excluding a directory with the same name
+		pattern, scenario C.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.yaml',
+			'!dir.yaml',
+		)
+		files = {
+			'dir.yaml/file.sql',
+			'dir.yaml/file.yaml',
+			'dir.yaml/index.txt',
+			'dir/file.sql',
+			'dir/file.yaml',
+			'dir/index.txt',
+			'file.yaml',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			#'dir.yaml/file.yaml',  # Discrepancy with Git.
+			'dir/file.yaml',
+			'file.yaml',
+		})
+		self.assertEqual(files - ignores, {
+			'dir.yaml/file.sql',
+			'dir.yaml/file.yaml',  # Discrepancy with Git.
+			'dir.yaml/index.txt',
+			'dir/file.sql',
+			'dir/index.txt',
+		})
+
+	def test_07_issue_62(self):
+		"""
+		Test including all files and excluding a directory.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*',
+			'!product_dir/',
+		)
+		results = set(spec.match_files(
+			'anydir/file.txt',
+			'product_dir/file.txt'
+		))
+		self.assertEqual(results, {
+			'anydir/file.txt',
+		})
+
+	def test_08_issue_39(self):
+		"""
+		Test excluding files in a directory.
+		"""
+		spec = PathSpec.from_lines('gitwildmatch', 
+			'*.log',
+			'!important/*.log',
+			'trace.*',
+		)
+		files = {
+			'a.log',
+			'b.txt',
+			'important/d.log',
+			'important/e.txt',
+			'trace.c',
+		}
+		ignores = set(spec.match_files(files))
+		self.assertEqual(ignores, {
+			'a.log',
+			'trace.c',
+		})
+		self.assertEqual(files - ignores, {
+			'b.txt',
+			'important/d.log',
+			'important/e.txt',
+		})

_service:tar_scm:pathspec-0.11.1.tar.gz/tests/test_util.py Added

@@ -0,0 +1,411 @@
+"""
+This script tests utility functions.
+"""
+
+import errno
+import os
+import os.path
+import pathlib
+import shutil
+import tempfile
+import unittest
+from functools import (
+	partial)
+from typing import (
+	Iterable,
+	Tuple)
+
+from pathspec.patterns.gitwildmatch import (
+	GitWildMatchPattern)
+from pathspec.util import (
+	RecursionError,
+	iter_tree_entries,
+	iter_tree_files,
+	match_file,
+	normalize_file)
+from tests.util import (
+	make_dirs,
+	make_files,
+	make_links,
+	mkfile,
+	ospath)
+
+
+class MatchFileTest(unittest.TestCase):
+	"""
+	The :class:`MatchFileTest` class tests the :meth:`.match_file`
+	function.
+	"""
+
+	def test_1_match_file(self):
+		"""
+		Test matching files individually.
+		"""
+		patterns = list(map(GitWildMatchPattern, 
+			'*.txt',
+			'!b.txt',
+		))
+		results = set(filter(partial(match_file, patterns), 
+			'X/a.txt',
+			'X/b.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/b.txt',
+			'Y/Z/c.txt',
+		))
+		self.assertEqual(results, {
+			'X/a.txt',
+			'X/Z/c.txt',
+			'Y/a.txt',
+			'Y/Z/c.txt',
+		})
+
+
+class IterTreeTest(unittest.TestCase):
+	"""
+	The :class:`IterTreeTest` class tests :meth:`.iter_tree_entries` and
+	:meth:`.iter_tree_files` functions.
+	"""
+
+	def make_dirs(self, dirs: Iterablestr) -> None:
+		"""
+		Create the specified directories.
+		"""
+		make_dirs(self.temp_dir, dirs)
+
+	def make_files(self, files: Iterablestr) -> None:
+		"""
+		Create the specified files.
+		"""
+		make_files(self.temp_dir, files)
+
+	def make_links(self, links: IterableTuplestr, str) -> None:
+		"""
+		Create the specified links.
+		"""
+		make_links(self.temp_dir, links)
+
+	def require_realpath(self) -> None:
+		"""
+		Skips the test if `os.path.realpath` does not properly support
+		symlinks.
+		"""
+		if self.broken_realpath:
+			raise unittest.SkipTest("`os.path.realpath` is broken.")
+
+	def require_symlink(self) -> None:
+		"""
+		Skips the test if `os.symlink` is not supported.
+		"""
+		if self.no_symlink:
+			raise unittest.SkipTest("`os.symlink` is not supported.")
+
+	def setUp(self) -> None:
+		"""
+		Called before each test.
+		"""
+		self.temp_dir = pathlib.Path(tempfile.mkdtemp())
+
+	def tearDown(self) -> None:
+		"""
+		Called after each test.
+		"""
+		shutil.rmtree(self.temp_dir)
+
+	def test_1_files(self):
+		"""
+		Tests to make sure all files are found.
+		"""
+		self.make_dirs(
+			'Empty',
+			'Dir',
+			'Dir/Inner',
+		)
+		self.make_files(
+			'a',
+			'b',
+			'Dir/c',
+			'Dir/d',
+			'Dir/Inner/e',
+			'Dir/Inner/f',
+		)
+		results = set(iter_tree_files(self.temp_dir))
+		self.assertEqual(results, set(map(ospath, 
+			'a',
+			'b',
+			'Dir/c',
+			'Dir/d',
+			'Dir/Inner/e',
+			'Dir/Inner/f',
+		)))
+
+	def test_2_0_check_symlink(self):
+		"""
+		Tests whether links can be created.
+		"""
+		# NOTE: Windows Vista and greater supports `os.symlink` for Python
+		# 3.2+.
+		no_symlink = None
+		try:
+			file = self.temp_dir / 'file'
+			link = self.temp_dir / 'link'
+			mkfile(file)
+
+			try:
+				os.symlink(file, link)
+			except (AttributeError, NotImplementedError, OSError):
+				no_symlink = True
+			else:
+				no_symlink = False
+
+		finally:
+			self.__class__.no_symlink = no_symlink
+
+	def test_2_1_check_realpath(self):
+		"""
+		Tests whether `os.path.realpath` works properly with symlinks.
+		"""
+		# NOTE: Windows does not follow symlinks with `os.path.realpath`
+		# which is what we use to detect recursion. See <https://bugs.python.org/issue9949>
+		# for details.
+		broken_realpath = None
+		try:
+			self.require_symlink()
+			file = self.temp_dir / 'file'
+			link = self.temp_dir / 'link'
+			mkfile(file)
+			os.symlink(file, link)
+
+			try:
+				self.assertEqual(os.path.realpath(file), os.path.realpath(link))
+			except AssertionError:
+				broken_realpath = True
+			else:
+				broken_realpath = False
+
+		finally:
+			self.__class__.broken_realpath = broken_realpath
+
+	def test_2_2_links(self):
+		"""
+		Tests to make sure links to directories and files work.
+		"""
+		self.require_symlink()
+		self.make_dirs(
+			'Dir',
+		)
+		self.make_files(
+			'a',
+			'b',
+			'Dir/c',
+			'Dir/d',
+		)
+		self.make_links(
+			('ax', 'a'),
+			('bx', 'b'),
+			('Dir/cx', 'Dir/c'),
+			('Dir/dx', 'Dir/d'),
+			('DirX', 'Dir'),
+		)
+		results = set(iter_tree_files(self.temp_dir))
+		self.assertEqual(results, set(map(ospath, 
+			'a',
+			'ax',
+			'b',
+			'bx',
+			'Dir/c',
+			'Dir/cx',
+			'Dir/d',
+			'Dir/dx',
+			'DirX/c',
+			'DirX/cx',
+			'DirX/d',
+			'DirX/dx',
+		)))
+
+	def test_2_3_sideways_links(self):
+		"""
+		Tests to make sure the same directory can be encountered multiple
+		times via links.
+		"""
+		self.require_symlink()
+		self.make_dirs(
+			'Dir',
+			'Dir/Target',
+		)
+		self.make_files(
+			'Dir/Target/file',
+		)
+		self.make_links(
+			('Ax', 'Dir'),
+			('Bx', 'Dir'),
+			('Cx', 'Dir/Target'),
+			('Dx', 'Dir/Target'),
+			('Dir/Ex', 'Dir/Target'),
+			('Dir/Fx', 'Dir/Target'),
+		)
+		results = set(iter_tree_files(self.temp_dir))
+		self.assertEqual(results, set(map(ospath, 
+			'Ax/Ex/file',
+			'Ax/Fx/file',
+			'Ax/Target/file',
+			'Bx/Ex/file',
+			'Bx/Fx/file',
+			'Bx/Target/file',
+			'Cx/file',
+			'Dx/file',
+			'Dir/Ex/file',
+			'Dir/Fx/file',
+			'Dir/Target/file',
+		)))
+
+	def test_2_4_recursive_links(self):
+		"""
+		Tests detection of recursive links.
+		"""
+		self.require_symlink()
+		self.require_realpath()
+		self.make_dirs(
+			'Dir',
+		)
+		self.make_files(
+			'Dir/file',
+		)
+		self.make_links(
+			('Dir/Self', 'Dir'),
+		)
+		with self.assertRaises(RecursionError) as context:
+			set(iter_tree_files(self.temp_dir))
+
+		self.assertEqual(context.exception.first_path, 'Dir')
+		self.assertEqual(context.exception.second_path, ospath('Dir/Self'))
+
+	def test_2_5_recursive_circular_links(self):
+		"""
+		Tests detection of recursion through circular links.
+		"""
+		self.require_symlink()
+		self.require_realpath()
+		self.make_dirs(
+			'A',
+			'B',
+			'C',
+		)
+		self.make_files(
+			'A/d',
+			'B/e',
+			'C/f',
+		)
+		self.make_links(
+			('A/Bx', 'B'),
+			('B/Cx', 'C'),
+			('C/Ax', 'A'),
+		)
+		with self.assertRaises(RecursionError) as context:
+			set(iter_tree_files(self.temp_dir))
+
+		self.assertIn(context.exception.first_path, ('A', 'B', 'C'))
+		self.assertEqual(context.exception.second_path, {
+			'A': ospath('A/Bx/Cx/Ax'),
+			'B': ospath('B/Cx/Ax/Bx'),
+			'C': ospath('C/Ax/Bx/Cx'),
+		}context.exception.first_path)
+
+	def test_2_6_detect_broken_links(self):
+		"""
+		Tests that broken links are detected.
+		"""
+		def reraise(e):
+			raise e
+
+		self.require_symlink()
+		self.make_links(
+			('A', 'DOES_NOT_EXIST'),
+		)
+		with self.assertRaises(OSError) as context:
+			set(iter_tree_files(self.temp_dir, on_error=reraise))
+
+		self.assertEqual(context.exception.errno, errno.ENOENT)
+
+	def test_2_7_ignore_broken_links(self):
+		"""
+		Tests that broken links are ignored.
+		"""
+		self.require_symlink()
+		self.make_links(
+			('A', 'DOES_NOT_EXIST'),
+		)
+		results = set(iter_tree_files(self.temp_dir))
+		self.assertEqual(results, set())
+
+	def test_2_8_no_follow_links(self):
+		"""
+		Tests to make sure directory links can be ignored.
+		"""
+		self.require_symlink()
+		self.make_dirs(
+			'Dir',
+		)
+		self.make_files(
+			'A',
+			'B',
+			'Dir/C',
+			'Dir/D',
+		)
+		self.make_links(
+			('Ax', 'A'),
+			('Bx', 'B'),
+			('Dir/Cx', 'Dir/C'),
+			('Dir/Dx', 'Dir/D'),
+			('DirX', 'Dir'),
+		)
+		results = set(iter_tree_files(self.temp_dir, follow_links=False))
+		self.assertEqual(results, set(map(ospath, 
+			'A',
+			'Ax',
+			'B',
+			'Bx',
+			'Dir/C',
+			'Dir/Cx',
+			'Dir/D',
+			'Dir/Dx',
+			'DirX',
+		)))
+
+	def test_3_entries(self):
+		"""
+		Tests to make sure all files are found.
+		"""
+		self.make_dirs(
+			'Empty',
+			'Dir',
+			'Dir/Inner',
+		)
+		self.make_files(
+			'a',
+			'b',
+			'Dir/c',
+			'Dir/d',
+			'Dir/Inner/e',
+			'Dir/Inner/f',
+		)
+		results = {entry.path for entry in iter_tree_entries(self.temp_dir)}
+		self.assertEqual(results, set(map(ospath, 
+			'a',
+			'b',
+			'Dir',
+			'Dir/c',
+			'Dir/d',
+			'Dir/Inner',
+			'Dir/Inner/e',
+			'Dir/Inner/f',
+			'Empty',
+		)))
+
+	def test_4_normalizing_pathlib_path(self):
+		"""
+		Tests normalizing a :class:`pathlib.PurePath` as argument.
+		"""
+		first_spec = normalize_file(pathlib.PurePath('a.txt'))
+		second_spec = normalize_file('a.txt')
+		self.assertEqual(first_spec, second_spec)

_service:tar_scm:pathspec-0.11.1.tar.gz/tests/util.py Added

@@ -0,0 +1,75 @@
+"""
+This module provides utility functions shared by tests.
+"""
+
+import os
+import os.path
+import pathlib
+
+from typing import (
+	Iterable,
+	Tuple)
+
+
+def make_dirs(temp_dir: pathlib.Path, dirs: Iterablestr) -> None:
+	"""
+	Create the specified directories.
+
+	*temp_dir* (:class:`pathlib.Path`) is the temporary directory to use.
+
+	*dirs* (:class:`Iterable` of :class:`str`) is the POSIX directory
+	paths (relative to *temp_dir*) to create.
+	"""
+	for dir in dirs:
+		os.mkdir(temp_dir / ospath(dir))
+
+
+def make_files(temp_dir: pathlib.Path, files: Iterablestr) -> None:
+	"""
+	Create the specified files.
+
+	*temp_dir* (:class:`pathlib.Path`) is the temporary directory to use.
+
+	*files* (:class:`Iterable` of :class:`str`) is the POSIX file paths
+	(relative to *temp_dir*) to create.
+	"""
+	for file in files:
+		mkfile(temp_dir / ospath(file))
+
+
+def make_links(temp_dir: pathlib.Path, links: IterableTuplestr, str) -> None:
+	"""
+	Create the specified links.
+
+	*temp_dir* (:class:`pathlib.Path`) is the temporary directory to use.
+
+	*links* (:class:`Iterable` of :class:`tuple`) contains the POSIX links
+	to create relative to *temp_dir*. Each link (:class:`tuple`) contains
+	the destination link path (:class:`str`) and source node path
+	(:class:`str`).
+	"""
+	for link, node in links:
+		src = temp_dir / ospath(node)
+		dest = temp_dir / ospath(link)
+		os.symlink(src, dest)
+
+
+def mkfile(file: pathlib.Path) -> None:
+	"""
+	Creates an empty file.
+
+	*file* (:class:`pathlib.Path`) is the native file path to create.
+	"""
+	with open(file, 'wb'):
+		pass
+
+
+def ospath(path: str) -> str:
+	"""
+	Convert the POSIX path to a native OS path.
+
+	*path* (:class:`str`) is the POSIX path.
+
+	Returns the native path (:class:`str`).
+	"""
+	return os.path.join(*path.split('/'))

_service:tar_scm:pathspec-0.11.1.tar.gz/tox.ini Added

_service:tar_scm:pathspec-0.8.1.tar.gz/. Deleted

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec Deleted

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec.egg-info Deleted

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec.egg-info/PKG-INFO Deleted

@@ -1,389 +0,0 @@
-Metadata-Version: 1.2
-Name: pathspec
-Version: 0.8.1
-Summary: Utility library for gitignore style pattern matching of file paths.
-Home-page: https://github.com/cpburnz/python-path-specification
-Author: Caleb P. Burns
-Author-email: cpburnz@gmail.com
-License: MPL 2.0
-Description: *pathspec*: Path Specification
-        ==============================
-        
-        *pathspec* is a utility library for pattern matching of file paths. So
-        far this only includes Git's wildmatch pattern matching which itself is
-        derived from Rsync's wildmatch. Git uses wildmatch for its `gitignore`_
-        files.
-        
-        .. _`gitignore`: http://git-scm.com/docs/gitignore
-        
-        
-        Tutorial
-        --------
-        
-        Say you have a "Projects" directory and you want to back it up, but only
-        certain files, and ignore others depending on certain conditions::
-        
-        	>>> import pathspec
-        	>>> # The gitignore-style patterns for files to select, but we're including
-        	>>> # instead of ignoring.
-        	>>> spec = """
-        	...
-        	... # This is a comment because the line begins with a hash: "#"
-        	...
-        	... # Include several project directories (and all descendants) relative to
-        	... # the current directory. To reference a directory you must end with a
-        	... # slash: "/"
-        	... /project-a/
-        	... /project-b/
-        	... /project-c/
-        	...
-        	... # Patterns can be negated by prefixing with exclamation mark: "!"
-        	...
-        	... # Ignore temporary files beginning or ending with "~" and ending with
-        	... # ".swp".
-        	... !~*
-        	... !*~
-        	... !*.swp
-        	...
-        	... # These are python projects so ignore compiled python files from
-        	... # testing.
-        	... !*.pyc
-        	...
-        	... # Ignore the build directories but only directly under the project
-        	... # directories.
-        	... !/*/build/
-        	...
-        	... """
-        
-        We want to use the ``GitWildMatchPattern`` class to compile our patterns. The
-        ``PathSpec`` class provides an interface around pattern implementations::
-        
-        	>>> spec = pathspec.PathSpec.from_lines(pathspec.patterns.GitWildMatchPattern, spec.splitlines())
-        
-        That may be a mouthful but it allows for additional patterns to be implemented
-        in the future without them having to deal with anything but matching the paths
-        sent to them. ``GitWildMatchPattern`` is the implementation of the actual
-        pattern which internally gets converted into a regular expression.
-        ``PathSpec`` is a simple wrapper around a list of compiled patterns.
-        
-        To make things simpler, we can use the registered name for a pattern class
-        instead of always having to provide a reference to the class itself. The
-        ``GitWildMatchPattern`` class is registered as **gitwildmatch**::
-        
-        	>>> spec = pathspec.PathSpec.from_lines('gitwildmatch', spec.splitlines())
-        
-        If we wanted to manually compile the patterns we can just do the following::
-        
-        	>>> patterns = map(pathspec.patterns.GitWildMatchPattern, spec.splitlines())
-        	>>> spec = PathSpec(patterns)
-        
-        ``PathSpec.from_lines()`` is simply a class method which does just that.
-        
-        If you want to load the patterns from file, you can pass the file instance
-        directly as well::
-        
-        	>>> with open('patterns.list', 'r') as fh:
-        	>>>     spec = pathspec.PathSpec.from_lines('gitwildmatch', fh)
-        
-        You can perform matching on a whole directory tree with::
-        
-        	>>> matches = spec.match_tree('path/to/directory')
-        
-        Or you can perform matching on a specific set of file paths with::
-        
-        	>>> matches = spec.match_files(file_paths)
-        
-        Or check to see if an individual file matches::
-        
-        	>>> is_matched = spec.match_file(file_path)
-        
-        
-        License
-        -------
-        
-        *pathspec* is licensed under the `Mozilla Public License Version 2.0`_. See
-        `LICENSE`_ or the `FAQ`_ for more information.
-        
-        In summary, you may use *pathspec* with any closed or open source project
-        without affecting the license of the larger work so long as you:
-        
-        - give credit where credit is due,
-        
-        - and release any custom changes made to *pathspec*.
-        
-        .. _`Mozilla Public License Version 2.0`: http://www.mozilla.org/MPL/2.0
-        .. _`LICENSE`: LICENSE
-        .. _`FAQ`: http://www.mozilla.org/MPL/2.0/FAQ.html
-        
-        
-        Source
-        ------
-        
-        The source code for *pathspec* is available from the GitHub repo
-        `cpburnz/python-path-specification`_.
-        
-        .. _`cpburnz/python-path-specification`: https://github.com/cpburnz/python-path-specification
-        
-        
-        Installation
-        ------------
-        
-        *pathspec* requires the following packages:
-        
-        - `setuptools`_
-        
-        *pathspec* can be installed from source with::
-        
-        	python setup.py install
-        
-        *pathspec* is also available for install through `PyPI`_::
-        
-        	pip install pathspec
-        
-        .. _`setuptools`: https://pypi.python.org/pypi/setuptools
-        .. _`PyPI`: http://pypi.python.org/pypi/pathspec
-        
-        
-        Documentation
-        -------------
-        
-        Documentation for *pathspec* is available on `Read the Docs`_.
-        
-        .. _`Read the Docs`: http://python-path-specification.readthedocs.io
-        
-        
-        Other Languages
-        ---------------
-        
-        *pathspec* is also available as a `Ruby gem`_.
-        
-        .. _`Ruby gem`: https://github.com/highb/pathspec-ruby
-        
-        Change History
-        ==============
-        
-        0.8.1 (2020-11-07)
-        ------------------
-        
-        - `Issue #43`_: Add support for addition operator.
-        
-        .. _`Issue #43`: https://github.com/cpburnz/python-path-specification/pull/43
-        
-        
-        0.8.0 (2020-04-09)
-        ------------------
-        
-        - `Issue #30`_: Expose what patterns matched paths. Added `util.detailed_match_files()`.
-        - `Issue #31`_: `match_tree()` doesn't return symlinks.
-        - `Issue #34`_: Support `pathlib.Path`\ s.
-        - Add `PathSpec.match_tree_entries` and `util.iter_tree_entries()` to support directories and symlinks.
-        - API change: `match_tree()` has been renamed to `match_tree_files()`. The old name `match_tree()` is still available as an alias.
-        - API change: `match_tree_files()` now returns symlinks. This is a bug fix but it will change the returned results.
-        
-        .. _`Issue #30`: https://github.com/cpburnz/python-path-specification/issues/30
-        .. _`Issue #31`: https://github.com/cpburnz/python-path-specification/issues/31
-        .. _`Issue #34`: https://github.com/cpburnz/python-path-specification/issues/34
-        
-        
-        0.7.0 (2019-12-27)
-        ------------------
-        
-        - `Issue #28`_: Add support for Python 3.8, and drop Python 3.4.
-        - `Issue #29`_: Publish bdist wheel.
-        
-        .. _`Issue #28`: https://github.com/cpburnz/python-path-specification/pull/28
-        .. _`Issue #29`: https://github.com/cpburnz/python-path-specification/pull/29
-        
-        
-        0.6.0 (2019-10-03)
-        ------------------
-        
-        - `Issue #24`_: Drop support for Python 2.6, 3.2, and 3.3.
-        - `Issue #25`_: Update README.rst.
-        - `Issue #26`_: Method to escape gitwildmatch.
-        
-        .. _`Issue #24`: https://github.com/cpburnz/python-path-specification/pull/24
-        .. _`Issue #25`: https://github.com/cpburnz/python-path-specification/pull/25
-        .. _`Issue #26`: https://github.com/cpburnz/python-path-specification/pull/26
-        
-        
-        0.5.9 (2018-09-15)
-        ------------------
-        
-        - Fixed file system error handling.
-        
-        
-        0.5.8 (2018-09-15)
-        ------------------
-        
-        - Improved type checking.
-        - Created scripts to test Python 2.6 because Tox removed support for it.
-        - Improved byte string handling in Python 3.
-        - `Issue #22`_: Handle dangling symlinks.
-        
-        .. _`Issue #22`: https://github.com/cpburnz/python-path-specification/issues/22
-        
-        
-        0.5.7 (2018-08-14)
-        ------------------
-        
-        - `Issue #21`_: Fix collections deprecation warning.
-        
-        .. _`Issue #21`: https://github.com/cpburnz/python-path-specification/issues/21
-        
-        
-        0.5.6 (2018-04-06)
-        ------------------
-        
-        - Improved unit tests.
-        - Improved type checking.
-        - `Issue #20`_: Support current directory prefix.
-        
-        .. _`Issue #20`: https://github.com/cpburnz/python-path-specification/issues/20
-        
-        
-        0.5.5 (2017-09-09)
-        ------------------
-        
-        - Add documentation link to README.
-        
-        
-        0.5.4 (2017-09-09)
-        ------------------
-        
-        - `Issue #17`_: Add link to Ruby implementation of *pathspec*.
-        - Add sphinx documentation.
-        
-        .. _`Issue #17`: https://github.com/cpburnz/python-path-specification/pull/17
-        
-        
-        0.5.3 (2017-07-01)
-        ------------------
-        
-        - `Issue #14`_: Fix byte strings for Python 3.
-        - `Issue #15`_: Include "LICENSE" in source package.
-        - `Issue #16`_: Support Python 2.6.
-        
-        .. _`Issue #14`: https://github.com/cpburnz/python-path-specification/issues/14
-        .. _`Issue #15`: https://github.com/cpburnz/python-path-specification/pull/15
-        .. _`Issue #16`: https://github.com/cpburnz/python-path-specification/issues/16
-        
-        
-        0.5.2 (2017-04-04)
-        ------------------
-        
-        - Fixed change log.
-        
-        
-        0.5.1 (2017-04-04)
-        ------------------
-        
-        - `Issue #13`_: Add equality methods to `PathSpec` and `RegexPattern`.
-        
-        .. _`Issue #13`: https://github.com/cpburnz/python-path-specification/pull/13
-        
-        
-        0.5.0 (2016-08-22)
-        ------------------
-        
-        - `Issue #12`_: Add `PathSpec.match_file()`.
-        - Renamed `gitignore.GitIgnorePattern` to `patterns.gitwildmatch.GitWildMatchPattern`.
-        - Deprecated `gitignore.GitIgnorePattern`.
-        
-        .. _`Issue #12`: https://github.com/cpburnz/python-path-specification/issues/12
-        
-        
-        0.4.0 (2016-07-15)
-        ------------------
-        
-        - `Issue #11`_: Support converting patterns into regular expressions without compiling them.
-        - API change: Subclasses of `RegexPattern` should implement `pattern_to_regex()`.
-        
-        .. _`Issue #11`: https://github.com/cpburnz/python-path-specification/issues/11
-        
-        
-        0.3.4 (2015-08-24)
-        ------------------
-        
-        - `Issue #7`_: Fixed non-recursive links.
-        - `Issue #8`_: Fixed edge cases in gitignore patterns.
-        - `Issue #9`_: Fixed minor usage documentation.
-        - Fixed recursion detection.
-        - Fixed trivial incompatibility with Python 3.2.
-        
-        .. _`Issue #7`: https://github.com/cpburnz/python-path-specification/pull/7
-        .. _`Issue #8`: https://github.com/cpburnz/python-path-specification/pull/8
-        .. _`Issue #9`: https://github.com/cpburnz/python-path-specification/pull/9
-        
-        
-        0.3.3 (2014-11-21)
-        ------------------
-        
-        - Improved documentation.
-        
-        
-        0.3.2 (2014-11-08)
-        ------------------
-        
-        - `Issue #5`_: Use tox for testing.
-        - `Issue #6`_: Fixed matching Windows paths.
-        - Improved documentation.
-        - API change: `spec.match_tree()` and `spec.match_files()` now return iterators instead of sets.
-        
-        .. _`Issue #5`: https://github.com/cpburnz/python-path-specification/pull/5
-        .. _`Issue #6`: https://github.com/cpburnz/python-path-specification/issues/6
-        
-        
-        0.3.1 (2014-09-17)
-        ------------------
-        
-        - Updated README.
-        
-        
-        0.3.0 (2014-09-17)
-        ------------------
-        
-        - `Issue #3`_: Fixed trailing slash in gitignore patterns.
-        - `Issue #4`_: Fixed test for trailing slash in gitignore patterns.
-        - Added registered patterns.
-        
-        .. _`Issue #3`: https://github.com/cpburnz/python-path-specification/pull/3
-        .. _`Issue #4`: https://github.com/cpburnz/python-path-specification/pull/4
-        
-        
-        0.2.2 (2013-12-17)
-        ------------------
-        
-        - Fixed setup.py.
-        
-        
-        0.2.1 (2013-12-17)
-        ------------------
-        
-        - Added tests.
-        - Fixed comment gitignore patterns.
-        - Fixed relative path gitignore patterns.
-        
-        
-        0.2.0 (2013-12-07)
-        ------------------
-        
-        - Initial release.
-Platform: UNKNOWN
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 2
-Classifier: Programming Language :: Python :: 2.7
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.5
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Programming Language :: Python :: Implementation :: PyPy
-Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Classifier: Topic :: Utilities
-Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec.egg-info/SOURCES.txt Deleted

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec.egg-info/dependency_links.txt Deleted

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec.egg-info/top_level.txt Deleted

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/compat.py Deleted

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/patterns Deleted

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/tests Deleted

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/tests/__init__.py Deleted

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/tests/test_gitwildmatch.py Deleted

@@ -1,474 +0,0 @@
-# encoding: utf-8
-"""
-This script tests ``GitWildMatchPattern``.
-"""
-from __future__ import unicode_literals
-
-import re
-import sys
-import unittest
-
-import pathspec.patterns.gitwildmatch
-import pathspec.util
-from pathspec.patterns.gitwildmatch import GitWildMatchPattern
-
-if sys.version_info0 >= 3:
-	unichr = chr
-
-
-class GitWildMatchTest(unittest.TestCase):
-	"""
-	The ``GitWildMatchTest`` class tests the ``GitWildMatchPattern``
-	implementation.
-	"""
-
-	def test_00_empty(self):
-		"""
-		Tests an empty pattern.
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('')
-		self.assertIsNone(include)
-		self.assertIsNone(regex)
-
-	def test_01_absolute(self):
-		"""
-		Tests an absolute path pattern.
-
-		This should match:
-
-			an/absolute/file/path
-			an/absolute/file/path/foo
-
-		This should NOT match:
-
-			foo/an/absolute/file/path
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('/an/absolute/file/path')
-		self.assertTrue(include)
-		self.assertEqual(regex, '^an/absolute/file/path(?:/.*)?$')
-
-		pattern = GitWildMatchPattern(re.compile(regex), include)
-		results = set(pattern.match(
-			'an/absolute/file/path',
-			'an/absolute/file/path/foo',
-			'foo/an/absolute/file/path',
-		))
-		self.assertEqual(results, {
-			'an/absolute/file/path',
-			'an/absolute/file/path/foo',
-		})
-
-	def test_01_absolute_root(self):
-		"""
-		Tests a single root absolute path pattern.
-
-		This should NOT match any file (according to git check-ignore
-		(v2.4.1)).
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('/')
-		self.assertIsNone(include)
-		self.assertIsNone(regex)
-
-	def test_01_relative(self):
-		"""
-		Tests a relative path pattern.
-
-		This should match:
-
-			spam
-			spam/
-			foo/spam
-			spam/foo
-			foo/spam/bar
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('spam')
-		self.assertTrue(include)
-		self.assertEqual(regex, '^(?:.+/)?spam(?:/.*)?$')
-
-		pattern = GitWildMatchPattern(re.compile(regex), include)
-		results = set(pattern.match(
-			'spam',
-			'spam/',
-			'foo/spam',
-			'spam/foo',
-			'foo/spam/bar',
-		))
-		self.assertEqual(results, {
-			'spam',
-			'spam/',
-			'foo/spam',
-			'spam/foo',
-			'foo/spam/bar',
-		})
-
-	def test_01_relative_nested(self):
-		"""
-		Tests a relative nested path pattern.
-
-		This should match:
-
-			foo/spam
-			foo/spam/bar
-
-		This should **not** match (according to git check-ignore (v2.4.1)):
-
-			bar/foo/spam
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('foo/spam')
-		self.assertTrue(include)
-		self.assertEqual(regex, '^foo/spam(?:/.*)?$')
-
-		pattern = GitWildMatchPattern(re.compile(regex), include)
-		results = set(pattern.match(
-			'foo/spam',
-			'foo/spam/bar',
-			'bar/foo/spam',
-		))
-		self.assertEqual(results, {
-			'foo/spam',
-			'foo/spam/bar',
-		})
-
-	def test_02_comment(self):
-		"""
-		Tests a comment pattern.
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('# Cork soakers.')
-		self.assertIsNone(include)
-		self.assertIsNone(regex)
-
-	def test_02_ignore(self):
-		"""
-		Tests an exclude pattern.
-
-		This should NOT match (according to git check-ignore (v2.4.1)):
-
-			temp/foo
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('!temp')
-		self.assertIsNotNone(include)
-		self.assertFalse(include)
-		self.assertEqual(regex, '^(?:.+/)?temp$')
-
-		pattern = GitWildMatchPattern(re.compile(regex), include)
-		results = set(pattern.match('temp/foo'))
-		self.assertEqual(results, set())
-
-	def test_03_child_double_asterisk(self):
-		"""
-		Tests a directory name with a double-asterisk child
-		directory.
-
-		This should match:
-
-			spam/bar
-
-		This should **not** match (according to git check-ignore (v2.4.1)):
-
-			foo/spam/bar
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('spam/**')
-		self.assertTrue(include)
-		self.assertEqual(regex, '^spam/.*$')
-
-		pattern = GitWildMatchPattern(re.compile(regex), include)
-		results = set(pattern.match(
-			'spam/bar',
-			'foo/spam/bar',
-		))
-		self.assertEqual(results, {'spam/bar'})
-
-	def test_03_inner_double_asterisk(self):
-		"""
-		Tests a path with an inner double-asterisk directory.
-
-		This should match:
-
-			left/bar/right
-			left/foo/bar/right
-			left/bar/right/foo
-
-		This should **not** match (according to git check-ignore (v2.4.1)):
-
-			foo/left/bar/right
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('left/**/right')
-		self.assertTrue(include)
-		self.assertEqual(regex, '^left(?:/.+)?/right(?:/.*)?$')
-
-		pattern = GitWildMatchPattern(re.compile(regex), include)
-		results = set(pattern.match(
-			'left/bar/right',
-			'left/foo/bar/right',
-			'left/bar/right/foo',
-			'foo/left/bar/right',
-		))
-		self.assertEqual(results, {
-			'left/bar/right',
-			'left/foo/bar/right',
-			'left/bar/right/foo',
-		})
-
-	def test_03_only_double_asterisk(self):
-		"""
-		Tests a double-asterisk pattern which matches everything.
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('**')
-		self.assertTrue(include)
-		self.assertEqual(regex, '^.+$')
-
-	def test_03_parent_double_asterisk(self):
-		"""
-		Tests a file name with a double-asterisk parent directory.
-
-		This should match:
-
-			foo/spam
-			foo/spam/bar
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('**/spam')
-		self.assertTrue(include)
-		self.assertEqual(regex, '^(?:.+/)?spam(?:/.*)?$')
-
-		pattern = GitWildMatchPattern(re.compile(regex), include)
-		results = set(pattern.match(
-			'foo/spam',
-			'foo/spam/bar',
-		))
-		self.assertEqual(results, {
-			'foo/spam',
-			'foo/spam/bar',
-		})
-
-	def test_04_infix_wildcard(self):
-		"""
-		Tests a pattern with an infix wildcard.
-
-		This should match:
-
-			foo--bar
-			foo-hello-bar
-			a/foo-hello-bar
-			foo-hello-bar/b
-			a/foo-hello-bar/b
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('foo-*-bar')
-		self.assertTrue(include)
-		self.assertEqual(regex, '^(?:.+/)?foo\\-^/*\\-bar(?:/.*)?$')
-
-		pattern = GitWildMatchPattern(re.compile(regex), include)
-		results = set(pattern.match(
-			'foo--bar',
-			'foo-hello-bar',
-			'a/foo-hello-bar',
-			'foo-hello-bar/b',
-			'a/foo-hello-bar/b',
-		))
-		self.assertEqual(results, {
-			'foo--bar',
-			'foo-hello-bar',
-			'a/foo-hello-bar',
-			'foo-hello-bar/b',
-			'a/foo-hello-bar/b',
-		})
-
-	def test_04_postfix_wildcard(self):
-		"""
-		Tests a pattern with a postfix wildcard.
-
-		This should match:
-
-			~temp-
-			~temp-foo
-			~temp-foo/bar
-			foo/~temp-bar
-			foo/~temp-bar/baz
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('~temp-*')
-		self.assertTrue(include)
-		self.assertEqual(regex, '^(?:.+/)?\\~temp\\-^/*(?:/.*)?$')
-
-		pattern = GitWildMatchPattern(re.compile(regex), include)
-		results = set(pattern.match(
-			'~temp-',
-			'~temp-foo',
-			'~temp-foo/bar',
-			'foo/~temp-bar',
-			'foo/~temp-bar/baz',
-		))
-		self.assertEqual(results, {
-			'~temp-',
-			'~temp-foo',
-			'~temp-foo/bar',
-			'foo/~temp-bar',
-			'foo/~temp-bar/baz',
-		})
-
-	def test_04_prefix_wildcard(self):
-		"""
-		Tests a pattern with a prefix wildcard.
-
-		This should match:
-
-			bar.py
-			bar.py/
-			foo/bar.py
-			foo/bar.py/baz
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('*.py')
-		self.assertTrue(include)
-		self.assertEqual(regex, '^(?:.+/)?^/*\\.py(?:/.*)?$')
-
-		pattern = GitWildMatchPattern(re.compile(regex), include)
-		results = set(pattern.match(
-			'bar.py',
-			'bar.py/',
-			'foo/bar.py',
-			'foo/bar.py/baz',
-		))
-		self.assertEqual(results, {
-			'bar.py',
-			'bar.py/',
-			'foo/bar.py',
-			'foo/bar.py/baz',
-		})
-
-	def test_05_directory(self):
-		"""
-		Tests a directory pattern.
-
-		This should match:
-
-			dir/
-			foo/dir/
-			foo/dir/bar
-
-		This should **not** match:
-
-			dir
-		"""
-		regex, include = GitWildMatchPattern.pattern_to_regex('dir/')
-		self.assertTrue(include)
-		self.assertEqual(regex, '^(?:.+/)?dir/.*$')
-
-		pattern = GitWildMatchPattern(re.compile(regex), include)
-		results = set(pattern.match(
-			'dir/',
-			'foo/dir/',
-			'foo/dir/bar',
-			'dir',
-		))
-		self.assertEqual(results, {
-			'dir/',
-			'foo/dir/',
-			'foo/dir/bar',
-		})
-
-	def test_06_registered(self):
-		"""
-		Tests that the pattern is registered.
-		"""
-		self.assertIs(pathspec.util.lookup_pattern('gitwildmatch'), GitWildMatchPattern)
-
-	def test_06_access_deprecated(self):
-		"""
-		Tests that the pattern is accessible from the root module using the
-		deprecated alias.
-		"""
-		self.assertTrue(hasattr(pathspec, 'GitIgnorePattern'))
-		self.assertTrue(issubclass(pathspec.GitIgnorePattern, GitWildMatchPattern))
-
-	def test_06_registered_deprecated(self):
-		"""
-		Tests that the pattern is registered under the deprecated alias.
-		"""
-		self.assertIs(pathspec.util.lookup_pattern('gitignore'), pathspec.GitIgnorePattern)
-
-	def test_07_encode_bytes(self):
-		"""
-		Test encoding bytes.
-		"""
-		encoded = "".join(map(unichr, range(0,256))).encode(pathspec.patterns.gitwildmatch._BYTES_ENCODING)
-		expected = b"\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f !\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ\\^_`abcdefghijklmnopqrstuvwxyz{|}~\x7f\x80\x81\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x8b\x8c\x8d\x8e\x8f\x90\x91\x92\x93\x94\x95\x96\x97\x98\x99\x9a\x9b\x9c\x9d\x9e\x9f\xa0\xa1\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xab\xac\xad\xae\xaf\xb0\xb1\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xcc\xcd\xce\xcf\xd0\xd1\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xdb\xdc\xdd\xde\xdf\xe0\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xeb\xec\xed\xee\xef\xf0\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xfb\xfc\xfd\xfe\xff"
-		self.assertEqual(encoded, expected)
-
-	def test_07_decode_bytes(self):
-		"""
-		Test decoding bytes.
-		"""
-		decoded = bytes(bytearray(range(0,256))).decode(pathspec.patterns.gitwildmatch._BYTES_ENCODING)
-		expected = "\x00\x01\x02\x03\x04\x05\x06\x07\x08\t\n\x0b\x0c\r\x0e\x0f\x10\x11\x12\x13\x14\x15\x16\x17\x18\x19\x1a\x1b\x1c\x1d\x1e\x1f !\"#$%&'()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ\\^_`abcdefghijklmnopqrstuvwxyz{|}~\x7f\x80\x81\x82\x83\x84\x85\x86\x87\x88\x89\x8a\x8b\x8c\x8d\x8e\x8f\x90\x91\x92\x93\x94\x95\x96\x97\x98\x99\x9a\x9b\x9c\x9d\x9e\x9f\xa0\xa1\xa2\xa3\xa4\xa5\xa6\xa7\xa8\xa9\xaa\xab\xac\xad\xae\xaf\xb0\xb1\xb2\xb3\xb4\xb5\xb6\xb7\xb8\xb9\xba\xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xcc\xcd\xce\xcf\xd0\xd1\xd2\xd3\xd4\xd5\xd6\xd7\xd8\xd9\xda\xdb\xdc\xdd\xde\xdf\xe0\xe1\xe2\xe3\xe4\xe5\xe6\xe7\xe8\xe9\xea\xeb\xec\xed\xee\xef\xf0\xf1\xf2\xf3\xf4\xf5\xf6\xf7\xf8\xf9\xfa\xfb\xfc\xfd\xfe\xff"
-		self.assertEqual(decoded, expected)
-
-	def test_07_match_bytes_and_bytes(self):
-		"""
-		Test byte string patterns matching byte string paths.
-		"""
-		pattern = GitWildMatchPattern(b'*.py')
-		results = set(pattern.match(b'a.py'))
-		self.assertEqual(results, {b'a.py'})
-
-	def test_07_match_bytes_and_bytes_complete(self):
-		"""
-		Test byte string patterns matching byte string paths.
-		"""
-		encoded = bytes(bytearray(range(0,256)))
-		escaped = b"".join(b"\\" + encodedi:i+1 for i in range(len(encoded)))
-		pattern = GitWildMatchPattern(escaped)
-		results = set(pattern.match(encoded))
-		self.assertEqual(results, {encoded})
-
-	@unittest.skipIf(sys.version_info0 >= 3, "Python 3 is strict")
-	def test_07_match_bytes_and_unicode(self):
-		"""
-		Test byte string patterns matching byte string paths.
-		"""
-		pattern = GitWildMatchPattern(b'*.py')
-		results = set(pattern.match('a.py'))
-		self.assertEqual(results, {'a.py'})
-
-	@unittest.skipIf(sys.version_info0 == 2, "Python 2 is lenient")
-	def test_07_match_bytes_and_unicode_fail(self):
-		"""
-		Test byte string patterns matching byte string paths.
-		"""
-		pattern = GitWildMatchPattern(b'*.py')
-		with self.assertRaises(TypeError):
-			for _ in pattern.match('a.py'):
-				pass
-
-	@unittest.skipIf(sys.version_info0 >= 3, "Python 3 is strict")
-	def test_07_match_unicode_and_bytes(self):
-		"""
-		Test unicode patterns with byte paths.
-		"""
-		pattern = GitWildMatchPattern('*.py')
-		results = set(pattern.match(b'a.py'))
-		self.assertEqual(results, {b'a.py'})
-
-	@unittest.skipIf(sys.version_info0 == 2, "Python 2 is lenient")
-	def test_07_match_unicode_and_bytes_fail(self):
-		"""
-		Test unicode patterns with byte paths.
-		"""
-		pattern = GitWildMatchPattern('*.py')
-		with self.assertRaises(TypeError):
-			for _ in pattern.match(b'a.py'):
-				pass
-
-	def test_07_match_unicode_and_unicode(self):
-		"""
-		Test unicode patterns with unicode paths.
-		"""
-		pattern = GitWildMatchPattern('*.py')
-		results = set(pattern.match('a.py'))
-		self.assertEqual(results, {'a.py'})
-
-	def test_08_escape(self):
-		"""
-		Test escaping a string with meta-characters
-		"""
-		fname = "file!with*weird#naming_1.t?t"
-		escaped = r"file\!with\*weird\#naming_\1\.t\?t"
-		result = GitWildMatchPattern.escape(fname)
-		self.assertEqual(result, escaped)

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/tests/test_pathspec.py Deleted

@@ -1,180 +0,0 @@
-# encoding: utf-8
-"""
-This script tests ``PathSpec``.
-"""
-
-import unittest
-
-import pathspec
-
-
-class PathSpecTest(unittest.TestCase):
-	"""
-	The ``PathSpecTest`` class tests the ``PathSpec`` class.
-	"""
-
-	def test_01_current_dir_paths(self):
-		"""
-		Tests that paths referencing the current directory will be properly
-		normalized and matched.
-		"""
-		spec = pathspec.PathSpec.from_lines('gitwildmatch', 
-			'*.txt',
-			'!test1/',
-		)
-		results = set(spec.match_files(
-			'./src/test1/a.txt',
-			'./src/test1/b.txt',
-			'./src/test1/c/c.txt',
-			'./src/test2/a.txt',
-			'./src/test2/b.txt',
-			'./src/test2/c/c.txt',
-		))
-		self.assertEqual(results, {
-			'./src/test2/a.txt',
-			'./src/test2/b.txt',
-			'./src/test2/c/c.txt',
-		})
-
-	def test_01_match_files(self):
-		"""
-		Tests that matching files one at a time yields the same results as
-		matching multiples files at once.
-		"""
-		spec = pathspec.PathSpec.from_lines('gitwildmatch', 
-			'*.txt',
-			'!test1/',
-		)
-		test_files = 
-			'src/test1/a.txt',
-			'src/test1/b.txt',
-			'src/test1/c/c.txt',
-			'src/test2/a.txt',
-			'src/test2/b.txt',
-			'src/test2/c/c.txt',
-		
-		single_results = set(filter(spec.match_file, test_files))
-		multi_results = set(spec.match_files(test_files))
-		self.assertEqual(single_results, multi_results)
-
-	def test_01_windows_current_dir_paths(self):
-		"""
-		Tests that paths referencing the current directory will be properly
-		normalized and matched.
-		"""
-		spec = pathspec.PathSpec.from_lines('gitwildmatch', 
-			'*.txt',
-			'!test1/',
-		)
-		results = set(spec.match_files(
-			'.\\src\\test1\\a.txt',
-			'.\\src\\test1\\b.txt',
-			'.\\src\\test1\\c\\c.txt',
-			'.\\src\\test2\\a.txt',
-			'.\\src\\test2\\b.txt',
-			'.\\src\\test2\\c\\c.txt',
-		, separators=('\\',)))
-		self.assertEqual(results, {
-			'.\\src\\test2\\a.txt',
-			'.\\src\\test2\\b.txt',
-			'.\\src\\test2\\c\\c.txt',
-		})
-
-	def test_01_windows_paths(self):
-		"""
-		Tests that Windows paths will be properly normalized and matched.
-		"""
-		spec = pathspec.PathSpec.from_lines('gitwildmatch', 
-			'*.txt',
-			'!test1/',
-		)
-		results = set(spec.match_files(
-			'src\\test1\\a.txt',
-			'src\\test1\\b.txt',
-			'src\\test1\\c\\c.txt',
-			'src\\test2\\a.txt',
-			'src\\test2\\b.txt',
-			'src\\test2\\c\\c.txt',
-		, separators=('\\',)))
-		self.assertEqual(results, {
-			'src\\test2\\a.txt',
-			'src\\test2\\b.txt',
-			'src\\test2\\c\\c.txt',
-		})
-
-	def test_02_eq(self):
-		"""
-		Tests equality.
-		"""
-		first_spec = pathspec.PathSpec.from_lines('gitwildmatch', 
-			'*.txt',
-			'!test1/',
-		)
-		second_spec = pathspec.PathSpec.from_lines('gitwildmatch', 
-			'*.txt',
-			'!test1/',
-		)
-		self.assertEqual(first_spec, second_spec)
-
-	def test_02_ne(self):
-		"""
-		Tests equality.
-		"""
-		first_spec = pathspec.PathSpec.from_lines('gitwildmatch', 
-			'*.txt',
-		)
-		second_spec = pathspec.PathSpec.from_lines('gitwildmatch', 
-			'!*.txt',
-		)
-		self.assertNotEqual(first_spec, second_spec)
-
-	def test_01_addition(self):
-		"""
-		Test pattern addition using + operator
-		"""
-		first_spec = pathspec.PathSpec.from_lines('gitwildmatch', 
-			'test.txt',
-			'test.png'
-		)
-		second_spec = pathspec.PathSpec.from_lines('gitwildmatch', 
-			'test.html',
-			'test.jpg'
-		)
-		combined_spec = first_spec + second_spec
-		results = set(combined_spec.match_files(
-			'test.txt',
-			'test.png',
-			'test.html',
-			'test.jpg'
-		, separators=('\\',)))
-		self.assertEqual(results, {
-			'test.txt',
-			'test.png',
-			'test.html',
-			'test.jpg'
-		})
-
-	def test_02_addition(self):
-		"""
-		Test pattern addition using += operator
-		"""
-		spec = pathspec.PathSpec.from_lines('gitwildmatch', 
-			'test.txt',
-			'test.png'
-		)
-		spec += pathspec.PathSpec.from_lines('gitwildmatch', 
-			'test.html',
-			'test.jpg'
-		)
-		results = set(spec.match_files(
-			'test.txt',
-			'test.png',
-			'test.html',
-			'test.jpg'
-		, separators=('\\',)))
-		self.assertEqual(results, {
-			'test.txt',
-			'test.png',
-			'test.html',
-			'test.jpg'
-		})

_service:tar_scm:pathspec-0.8.1.tar.gz/pathspec/tests/test_util.py Deleted

@@ -1,380 +0,0 @@
-# encoding: utf-8
-"""
-This script tests utility functions.
-"""
-
-import errno
-import os
-import os.path
-import shutil
-import sys
-import tempfile
-import unittest
-
-from pathspec.util import iter_tree_entries, iter_tree_files, RecursionError, normalize_file
-
-
-class IterTreeTest(unittest.TestCase):
-	"""
-	The ``IterTreeTest`` class tests `pathspec.util.iter_tree_files()`.
-	"""
-
-	def make_dirs(self, dirs):
-		"""
-		Create the specified directories.
-		"""
-		for dir in dirs:
-			os.mkdir(os.path.join(self.temp_dir, self.ospath(dir)))
-
-	def make_files(self, files):
-		"""
-		Create the specified files.
-		"""
-		for file in files:
-			self.mkfile(os.path.join(self.temp_dir, self.ospath(file)))
-
-	def make_links(self, links):
-		"""
-		Create the specified links.
-		"""
-		for link, node in links:
-			os.symlink(os.path.join(self.temp_dir, self.ospath(node)), os.path.join(self.temp_dir, self.ospath(link)))
-
-	@staticmethod
-	def mkfile(file):
-		"""
-		Creates an empty file.
-		"""
-		with open(file, 'wb'):
-			pass
-
-	@staticmethod
-	def ospath(path):
-		"""
-		Convert the POSIX path to a native OS path.
-		"""
-		return os.path.join(*path.split('/'))
-
-	def require_realpath(self):
-		"""
-		Skips the test if `os.path.realpath` does not properly support
-		symlinks.
-		"""
-		if self.broken_realpath:
-			raise unittest.SkipTest("`os.path.realpath` is broken.")
-
-	def require_symlink(self):
-		"""
-		Skips the test if `os.symlink` is not supported.
-		"""
-		if self.no_symlink:
-			raise unittest.SkipTest("`os.symlink` is not supported.")
-
-	def setUp(self):
-		"""
-		Called before each test.
-		"""
-		self.temp_dir = tempfile.mkdtemp()
-
-	def tearDown(self):
-		"""
-		Called after each test.
-		"""
-		shutil.rmtree(self.temp_dir)
-
-	def test_1_files(self):
-		"""
-		Tests to make sure all files are found.
-		"""
-		self.make_dirs(
-			'Empty',
-			'Dir',
-			'Dir/Inner',
-		)
-		self.make_files(
-			'a',
-			'b',
-			'Dir/c',
-			'Dir/d',
-			'Dir/Inner/e',
-			'Dir/Inner/f',
-		)
-		results = set(iter_tree_files(self.temp_dir))
-		self.assertEqual(results, set(map(self.ospath, 
-			'a',
-			'b',
-			'Dir/c',
-			'Dir/d',
-			'Dir/Inner/e',
-			'Dir/Inner/f',
-		)))
-
-	def test_2_0_check_symlink(self):
-		"""
-		Tests whether links can be created.
-		"""
-		# NOTE: Windows does not support `os.symlink` for Python 2. Windows
-		# Vista and greater supports `os.symlink` for Python 3.2+.
-		no_symlink = None
-		try:
-			file = os.path.join(self.temp_dir, 'file')
-			link = os.path.join(self.temp_dir, 'link')
-			self.mkfile(file)
-
-			try:
-				os.symlink(file, link)
-			except (AttributeError, NotImplementedError):
-				no_symlink = True
-				raise
-			no_symlink = False
-
-		finally:
-			self.__class__.no_symlink = no_symlink
-
-	def test_2_1_check_realpath(self):
-		"""
-		Tests whether `os.path.realpath` works properly with symlinks.
-		"""
-		# NOTE: Windows does not follow symlinks with `os.path.realpath`
-		# which is what we use to detect recursion. See <https://bugs.python.org/issue9949>
-		# for details.
-		broken_realpath = None
-		try:
-			self.require_symlink()
-			file = os.path.join(self.temp_dir, 'file')
-			link = os.path.join(self.temp_dir, 'link')
-			self.mkfile(file)
-			os.symlink(file, link)
-
-			try:
-				self.assertEqual(os.path.realpath(file), os.path.realpath(link))
-			except AssertionError:
-				broken_realpath = True
-				raise
-			broken_realpath = False
-
-		finally:
-			self.__class__.broken_realpath = broken_realpath
-
-	def test_2_2_links(self):
-		"""
-		Tests to make sure links to directories and files work.
-		"""
-		self.require_symlink()
-		self.make_dirs(
-			'Dir',
-		)
-		self.make_files(
-			'a',
-			'b',
-			'Dir/c',
-			'Dir/d',
-		)
-		self.make_links(
-			('ax', 'a'),
-			('bx', 'b'),
-			('Dir/cx', 'Dir/c'),
-			('Dir/dx', 'Dir/d'),
-			('DirX', 'Dir'),
-		)
-		results = set(iter_tree_files(self.temp_dir))
-		self.assertEqual(results, set(map(self.ospath, 
-			'a',
-			'ax',
-			'b',
-			'bx',
-			'Dir/c',
-			'Dir/cx',
-			'Dir/d',
-			'Dir/dx',
-			'DirX/c',
-			'DirX/cx',
-			'DirX/d',
-			'DirX/dx',
-		)))
-
-	def test_2_3_sideways_links(self):
-		"""
-		Tests to make sure the same directory can be encountered multiple
-		times via links.
-		"""
-		self.require_symlink()
-		self.make_dirs(
-			'Dir',
-			'Dir/Target',
-		)
-		self.make_files(
-			'Dir/Target/file',
-		)
-		self.make_links(
-			('Ax', 'Dir'),
-			('Bx', 'Dir'),
-			('Cx', 'Dir/Target'),
-			('Dx', 'Dir/Target'),
-			('Dir/Ex', 'Dir/Target'),
-			('Dir/Fx', 'Dir/Target'),
-		)
-		results = set(iter_tree_files(self.temp_dir))
-		self.assertEqual(results, set(map(self.ospath, 
-			'Ax/Ex/file',
-			'Ax/Fx/file',
-			'Ax/Target/file',
-			'Bx/Ex/file',
-			'Bx/Fx/file',
-			'Bx/Target/file',
-			'Cx/file',
-			'Dx/file',
-			'Dir/Ex/file',
-			'Dir/Fx/file',
-			'Dir/Target/file',
-		)))
-
-	def test_2_4_recursive_links(self):
-		"""
-		Tests detection of recursive links.
-		"""
-		self.require_symlink()
-		self.require_realpath()
-		self.make_dirs(
-			'Dir',
-		)
-		self.make_files(
-			'Dir/file',
-		)
-		self.make_links(
-			('Dir/Self', 'Dir'),
-		)
-		with self.assertRaises(RecursionError) as context:
-			set(iter_tree_files(self.temp_dir))
-		self.assertEqual(context.exception.first_path, 'Dir')
-		self.assertEqual(context.exception.second_path, self.ospath('Dir/Self'))
-
-	def test_2_5_recursive_circular_links(self):
-		"""
-		Tests detection of recursion through circular links.
-		"""
-		self.require_symlink()
-		self.require_realpath()
-		self.make_dirs(
-			'A',
-			'B',
-			'C',
-		)
-		self.make_files(
-			'A/d',
-			'B/e',
-			'C/f',
-		)
-		self.make_links(
-			('A/Bx', 'B'),
-			('B/Cx', 'C'),
-			('C/Ax', 'A'),
-		)
-		with self.assertRaises(RecursionError) as context:
-			set(iter_tree_files(self.temp_dir))
-		self.assertIn(context.exception.first_path, ('A', 'B', 'C'))
-		self.assertEqual(context.exception.second_path, {
-			'A': self.ospath('A/Bx/Cx/Ax'),
-			'B': self.ospath('B/Cx/Ax/Bx'),
-			'C': self.ospath('C/Ax/Bx/Cx'),
-		}context.exception.first_path)
-
-	def test_2_6_detect_broken_links(self):
-		"""
-		Tests that broken links are detected.
-		"""
-		def reraise(e):
-			raise e
-
-		self.require_symlink()
-		self.make_links(
-			('A', 'DOES_NOT_EXIST'),
-		)
-		with self.assertRaises(OSError) as context:
-			set(iter_tree_files(self.temp_dir, on_error=reraise))
-		self.assertEqual(context.exception.errno, errno.ENOENT)
-
-	def test_2_7_ignore_broken_links(self):
-		"""
-		Tests that broken links are ignored.
-		"""
-		self.require_symlink()
-		self.make_links(
-			('A', 'DOES_NOT_EXIST'),
-		)
-		results = set(iter_tree_files(self.temp_dir))
-		self.assertEqual(results, set())
-
-	def test_2_8_no_follow_links(self):
-		"""
-		Tests to make sure directory links can be ignored.
-		"""
-		self.require_symlink()
-		self.make_dirs(
-			'Dir',
-		)
-		self.make_files(
-			'A',
-			'B',
-			'Dir/C',
-			'Dir/D',
-		)
-		self.make_links(
-			('Ax', 'A'),
-			('Bx', 'B'),
-			('Dir/Cx', 'Dir/C'),
-			('Dir/Dx', 'Dir/D'),
-			('DirX', 'Dir'),
-		)
-		results = set(iter_tree_files(self.temp_dir, follow_links=False))
-		self.assertEqual(results, set(map(self.ospath, 
-			'A',
-			'Ax',
-			'B',
-			'Bx',
-			'Dir/C',
-			'Dir/Cx',
-			'Dir/D',
-			'Dir/Dx',
-			'DirX',
-		)))
-
-	def test_3_entries(self):
-		"""
-		Tests to make sure all files are found.
-		"""
-		self.make_dirs(
-			'Empty',
-			'Dir',
-			'Dir/Inner',
-		)
-		self.make_files(
-			'a',
-			'b',
-			'Dir/c',
-			'Dir/d',
-			'Dir/Inner/e',
-			'Dir/Inner/f',
-		)
-		results = {entry.path for entry in iter_tree_entries(self.temp_dir)}
-		self.assertEqual(results, set(map(self.ospath, 
-			'a',
-			'b',
-			'Dir',
-			'Dir/c',
-			'Dir/d',
-			'Dir/Inner',
-			'Dir/Inner/e',
-			'Dir/Inner/f',
-			'Empty',
-		)))
-
-	@unittest.skipIf(sys.version_info < (3, 4), "pathlib entered stdlib in Python 3.4")
-	def test_4_normalizing_pathlib_path(self):
-		"""
-		Tests passing pathlib.Path as argument.
-		"""
-		from pathlib import Path
-		first_spec = normalize_file(Path('a.txt'))
-		second_spec = normalize_file('a.txt')
-		self.assertEqual(first_spec, second_spec)