开源软件构建与测试

We truncated the diff of some files because they were too big. If you want to see the full diff for every file, click here.

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

_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
-        
-

_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.

_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:
+		"""

_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

_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}>/).*)?')

_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
 
-

_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',

_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

_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/',
+		)

_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',

_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)
-        ------------------

_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)

_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.