Metadata-Version: 2.1
Name: upathlib
Version: 0.6.9
Summary: The package upathlib
Author-email: Zepu Zhang <zepu.zhang@gmail.com>
Requires-Python: >=3.8
Description-Content-Type: text/x-rst
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: filelock >=3.3.0
Requires-Dist: deprecation
Requires-Dist: opnieuw
Requires-Dist: orjson >=3.6.0
Requires-Dist: overrides
Requires-Dist: tqdm
Requires-Dist: zstandard >=0.18.0
Requires-Dist: azure-storage-blob >=12.9.0,<13.0 ; extra == "abs"
Requires-Dist: sphinx < 6.0.0 ; extra == "doc"
Requires-Dist: numpydoc ; extra == "doc"
Requires-Dist: pydata-sphinx-theme ; extra == "doc"
Requires-Dist: google-auth ; extra == "gcs"
Requires-Dist: google-api-python-client >=2.13.9,<3.0 ; extra == "gcs"
Requires-Dist: google-cloud-storage >=2.0,<3.0 ; extra == "gcs"
Requires-Dist: requests ; extra == "gcs"
Requires-Dist: bandit ; extra == "test"
Requires-Dist: coverage[toml] ; extra == "test"
Requires-Dist: flake8 ; extra == "test"
Requires-Dist: mypy ; extra == "test"
Requires-Dist: numpy ; extra == "test"
Requires-Dist: pylint ; extra == "test"
Requires-Dist: pytest ; extra == "test"
Requires-Dist: pytest-mock ; extra == "test"
Project-URL: Source, https://github.com/zpz/upathlib
Provides-Extra: abs
Provides-Extra: doc
Provides-Extra: gcs
Provides-Extra: test

upathlib
========

The package ``upathlib``
defines a unified API for cloud blob store (aka "object store") as well as local file systems.

End user should look to the class ``Upath`` for documentation on the API.
Local file system and Google Cloud Storage are implemented by subclasses
``LocalUpath`` and ``GcsBlobUpath``, respectively.

To install, do one of the following::


    $ pip3 install upathlib
    $ pip3 install upathlib[gcs]


Read the `documentation <https://upathlib.readthedocs.io/en/latest/>`_.

Status
------

The style of the API is largely stable. The implementations for local file system and for Google Cloud Storage are production ready.

The implementation for Azure was once in production use, but not anymore by myself, hence is unreliable.
There is a much older implementation for AWS, which was moved to "archive", because it was not updated to the current API.

