Metadata-Version: 2.1
Name: upathlib
Version: 0.7.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.9.1
Requires-Dist: deprecation
Requires-Dist: tqdm
Requires-Dist: typing-extensions
Requires-Dist: mpservice >= 0.12.5
Requires-Dist: azure-storage-blob >=12.9.0,<13.0 ; extra == "abs"
Requires-Dist: sphinx ; 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: lz4 ; extra == "lz4"
Requires-Dist: black ; extra == "test"
Requires-Dist: mypy ; extra == "test"
Requires-Dist: numpy ; extra == "test"
Requires-Dist: pytest-mock ; extra == "test"
Requires-Dist: ruff ; extra == "test"
Requires-Dist: zstandard ; extra == "zstandard"
Project-URL: Source, https://github.com/zpz/upathlib
Provides-Extra: abs
Provides-Extra: doc
Provides-Extra: gcs
Provides-Extra: lz4
Provides-Extra: test
Provides-Extra: zstandard

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.


Python version
--------------

Development and testing were conducted in Python 3.8 until version 0.7.3.
Starting with 0.7.4, development and testing happen in Python 3.10.
Code continues to NOT intentionally use features beyond Python 3.8.
I intend to test agsint versions 3.8, 3.9, 3.10, 3.11 once I find time to set that up.

