diff options
author | robot-piglet <robot-piglet@yandex-team.com> | 2023-12-02 01:45:21 +0300 |
---|---|---|
committer | robot-piglet <robot-piglet@yandex-team.com> | 2023-12-02 02:42:50 +0300 |
commit | 9c43d58f75cf086b744cf4fe2ae180e8f37e4a0c (patch) | |
tree | 9f88a486917d371d099cd712efd91b4c122d209d /contrib/python/path/.dist-info/METADATA | |
parent | 32fb6dda1feb24f9ab69ece5df0cb9ec238ca5e6 (diff) | |
download | ydb-9c43d58f75cf086b744cf4fe2ae180e8f37e4a0c.tar.gz |
Intermediate changes
Diffstat (limited to 'contrib/python/path/.dist-info/METADATA')
-rw-r--r-- | contrib/python/path/.dist-info/METADATA | 201 |
1 files changed, 201 insertions, 0 deletions
diff --git a/contrib/python/path/.dist-info/METADATA b/contrib/python/path/.dist-info/METADATA new file mode 100644 index 0000000000..7cddb38723 --- /dev/null +++ b/contrib/python/path/.dist-info/METADATA @@ -0,0 +1,201 @@ +Metadata-Version: 2.1 +Name: path +Version: 16.7.1 +Summary: A module wrapper for os.path +Home-page: https://github.com/jaraco/path +Author: Jason Orendorff +Author-email: jason.orendorff@gmail.com +Maintainer: Jason R. Coombs +Maintainer-email: jaraco@jaraco.com +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Operating System :: OS Independent +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Requires-Python: >=3.8 +License-File: LICENSE +Provides-Extra: docs +Requires-Dist: sphinx (>=3.5) ; extra == 'docs' +Requires-Dist: jaraco.packaging (>=9.3) ; extra == 'docs' +Requires-Dist: rst.linker (>=1.9) ; extra == 'docs' +Requires-Dist: furo ; extra == 'docs' +Requires-Dist: sphinx-lint ; extra == 'docs' +Requires-Dist: jaraco.tidelift (>=1.4) ; extra == 'docs' +Provides-Extra: testing +Requires-Dist: pytest (>=6) ; extra == 'testing' +Requires-Dist: pytest-checkdocs (>=2.4) ; extra == 'testing' +Requires-Dist: pytest-cov ; extra == 'testing' +Requires-Dist: pytest-enabler (>=2.2) ; extra == 'testing' +Requires-Dist: pytest-ruff ; extra == 'testing' +Requires-Dist: appdirs ; extra == 'testing' +Requires-Dist: packaging ; extra == 'testing' +Requires-Dist: pygments ; extra == 'testing' +Requires-Dist: pytest-black (>=0.3.7) ; (platform_python_implementation != "PyPy") and extra == 'testing' +Requires-Dist: pytest-mypy (>=0.9.1) ; (platform_python_implementation != "PyPy") and extra == 'testing' +Requires-Dist: pywin32 ; (platform_system == "Windows" and python_version < "3.12") and extra == 'testing' + +.. image:: https://img.shields.io/pypi/v/path.svg + :target: https://pypi.org/project/path + +.. image:: https://img.shields.io/pypi/pyversions/path.svg + +.. image:: https://github.com/jaraco/path/workflows/tests/badge.svg + :target: https://github.com/jaraco/path/actions?query=workflow%3A%22tests%22 + :alt: tests + +.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json + :target: https://github.com/astral-sh/ruff + :alt: Ruff + +.. image:: https://img.shields.io/badge/code%20style-black-000000.svg + :target: https://github.com/psf/black + :alt: Code style: Black + +.. image:: https://readthedocs.org/projects/path/badge/?version=latest + :target: https://path.readthedocs.io/en/latest/?badge=latest + +.. image:: https://img.shields.io/badge/skeleton-2023-informational + :target: https://blog.jaraco.com/skeleton + +.. image:: https://tidelift.com/badges/package/pypi/path + :target: https://tidelift.com/subscription/pkg/pypi-path?utm_source=pypi-path&utm_medium=readme + + +``path`` (aka path pie, formerly ``path.py``) implements path +objects as first-class entities, allowing common operations on +files to be invoked on those path objects directly. For example: + +.. code-block:: python + + from path import Path + + d = Path("/home/guido/bin") + for f in d.files("*.py"): + f.chmod(0o755) + + # Globbing + for f in d.files("*.py"): + f.chmod("u+rwx") + + # Changing the working directory: + with Path("somewhere"): + # cwd in now `somewhere` + ... + + # Concatenate paths with / + foo_txt = Path("bar") / "foo.txt" + +Path pie is `hosted at Github <https://github.com/jaraco/path>`_. + +Find `the documentation here <https://path.readthedocs.io>`_. + +Guides and Testimonials +======================= + +Yasoob wrote the Python 101 `Writing a Cleanup Script +<http://freepythontips.wordpress.com/2014/01/23/python-101-writing-a-cleanup-script/>`_ +based on ``path``. + +Advantages +========== + +Python 3.4 introduced +`pathlib <https://docs.python.org/3/library/pathlib.html>`_, +which shares many characteristics with ``path``. In particular, +it provides an object encapsulation for representing filesystem paths. +One may have imagined ``pathlib`` would supersede ``path``. + +But the implementation and the usage quickly diverge, and ``path`` +has several advantages over ``pathlib``: + +- ``path`` implements ``Path`` objects as a subclass of + ``str``, and as a result these ``Path`` + objects may be passed directly to other APIs that expect simple + text representations of paths, whereas with ``pathlib``, one + must first cast values to strings before passing them to + APIs unaware of ``pathlib``. This shortcoming was `addressed + by PEP 519 <https://www.python.org/dev/peps/pep-0519/>`_, + in Python 3.6. +- ``path`` goes beyond exposing basic functionality of a path + and exposes commonly-used behaviors on a path, providing + methods like ``rmtree`` (from shlib) and ``remove_p`` (remove + a file if it exists). +- As a PyPI-hosted package, ``path`` is free to iterate + faster than a stdlib package. Contributions are welcome + and encouraged. +- ``path`` provides a uniform abstraction over its Path object, + freeing the implementer to subclass it readily. One cannot + subclass a ``pathlib.Path`` to add functionality, but must + subclass ``Path``, ``PosixPath``, and ``WindowsPath``, even + if one only wishes to add a ``__dict__`` to the subclass + instances. ``path`` instead allows the ``Path.module`` + object to be overridden by subclasses, defaulting to the + ``os.path``. Even advanced uses of ``path.Path`` that + subclass the model do not need to be concerned with + OS-specific nuances. + +This path project has the explicit aim to provide compatibility +with ``pathlib`` objects where possible, such that a ``path.Path`` +object is a drop-in replacement for ``pathlib.Path*`` objects. +This project welcomes contributions to improve that compatibility +where it's lacking. + +Alternatives +============ + +In addition to +`pathlib <https://docs.python.org/3/library/pathlib.html>`_, the +`pylib project <https://pypi.org/project/py/>`_ implements a +`LocalPath <https://github.com/pytest-dev/py/blob/72601dc8bbb5e11298bf9775bb23b0a395deb09b/py/_path/local.py#L106>`_ +class, which shares some behaviors and interfaces with ``path``. + +Development +=========== + +To install a development version, use the Github links to clone or +download a snapshot of the latest code. Alternatively, if you have git +installed, you may be able to use ``pip`` to install directly from +the repository:: + + pip install git+https://github.com/jaraco/path.git + +Testing +======= + +Tests are invoked with `tox <https://pypi.org/project/tox>`_. After +having installed tox, simply invoke ``tox`` in a checkout of the repo +to invoke the tests. + +Tests are also run in continuous integration. See the badges above +for links to the CI runs. + +Releasing +========= + +Tagged releases are automatically published to PyPI by Azure +Pipelines, assuming the tests pass. + +Origins +======= + +The ``path.py`` project was initially released in 2003 by Jason Orendorff +and has been continuously developed and supported by several maintainers +over the years. + +For Enterprise +============== + +Available as part of the Tidelift Subscription. + +This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. + +`Learn more <https://tidelift.com/subscription/pkg/pypi-path?utm_source=pypi-path&utm_medium=referral&utm_campaign=github>`_. + +Security Contact +================ + +To report a security vulnerability, please use the +`Tidelift security contact <https://tidelift.com/security>`_. +Tidelift will coordinate the fix and disclosure. |