Metadata-Version: 2.4
Name: unicloud
Version: 0.4.1
Summary: cloud storage utils package
Project-URL: Homepage, https://github.com/serapeum-org/unicloud
Project-URL: Documentation, https://serapeum-org.github.io/unicloud/
Project-URL: Repository, https://github.com/serapeum-org/unicloud
Author-email: Mostafa Farrag <moah.farrag@gmail.com>
License: GPL-3.0-or-later
License-File: LICENSE.md
Keywords: aws,cloud,gcs,google-cloud-storage,s3,storage
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Archiving
Requires-Python: <4,>=3.11
Requires-Dist: loguru>=0.7.2
Requires-Dist: numpy>=2.1.2
Requires-Dist: pandas>=2.2.0
Provides-Extra: all
Requires-Dist: boto3>=1.35.40; extra == 'all'
Requires-Dist: google-api-python-client>=2.119.0; extra == 'all'
Requires-Dist: google-cloud-storage>=2.1.0; extra == 'all'
Provides-Extra: gcs
Requires-Dist: google-api-python-client>=2.119.0; extra == 'gcs'
Requires-Dist: google-cloud-storage>=2.1.0; extra == 'gcs'
Provides-Extra: s3
Requires-Dist: boto3>=1.35.40; extra == 's3'
Description-Content-Type: text/markdown

[![Deploy MkDocs](https://github.com/serapeum-org/unicloud/actions/workflows/github-pages-mkdocs.yml/badge.svg)](https://serapeum-org.github.io/unicloud/)
[![Python Versions](https://img.shields.io/pypi/pyversions/unicloud.png)](https://img.shields.io/pypi/pyversions/unicloud)
[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
[![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/serapeum-org/unicloud.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/serapeum-org/unicloud/context:python)

![GitHub last commit](https://img.shields.io/github/last-commit/serapeum-org/unicloud)
![GitHub forks](https://img.shields.io/github/forks/serapeum-org/unicloud?style=social)
![GitHub Repo stars](https://img.shields.io/github/stars/serapeum-org/unicloud?style=social)
[![codecov](https://codecov.io/gh/serapeum-org/unicloud/branch/main/graph/badge.svg?token=g0DV4dCa8N)](https://codecov.io/gh/serapeum-org/unicloud)
[![Codacy Badge](https://app.codacy.com/project/badge/Grade/5e3aa4d0acc843d1a91caf33545ecf03)](https://www.codacy.com/gh/serapeum-org/unicloud/dashboard?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=serapeum-org/unicloud&amp;utm_campaign=Badge_Grade)

![GitHub commits since latest release (by SemVer including pre-releases)](https://img.shields.io/github/commits-since/serapeum-org/unicloud/0.5.0?include_prereleases&style=plastic)
![GitHub last commit](https://img.shields.io/github/last-commit/serapeum-org/unicloud)

Current release info
====================

| Name                                                                                                                 | Downloads                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Version                                                                                                                                                                                                                     | Platforms                                                                                                                                                                                                                                                                                                                                 |
|----------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [![Conda Recipe](https://img.shields.io/badge/recipe-unicloud-green.svg)](https://anaconda.org/conda-forge/unicloud) | [![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/unicloud.svg)](https://anaconda.org/conda-forge/unicloud) [![Downloads](https://pepy.tech/badge/unicloud)](https://pepy.tech/project/unicloud) [![Downloads](https://pepy.tech/badge/unicloud/month)](https://pepy.tech/project/unicloud)  [![Downloads](https://pepy.tech/badge/unicloud/week)](https://pepy.tech/project/unicloud)  ![PyPI - Downloads](https://img.shields.io/pypi/dd/unicloud?color=blue&style=flat-square) | [![Conda Version](https://img.shields.io/conda/vn/conda-forge/unicloud.svg)](https://anaconda.org/conda-forge/unicloud) [![PyPI version](https://badge.fury.io/py/unicloud.svg)](https://badge.fury.io/py/unicloud) | [![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/unicloud.svg)](https://anaconda.org/conda-forge/unicloud) [![Join the chat at https://gitter.im/unicloud/unicloud](https://badges.gitter.im/unicloud/unicloud.svg)](https://gitter.im/unicloud/unicloud?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) |

Conda-forge build status
========================
<table><tr><td>All platforms:</td>
    <td>
      <a href="https://dev.azure.com/conda-forge/feedstock-builds/_build/latest?definitionId=21798&branchName=main">
        <img src="https://dev.azure.com/conda-forge/feedstock-builds/_apis/build/status/unicloud-feedstock?branchName=main">
      </a>
    </td>
  </tr>
</table>

- feedstock link: [unicloud](https://github.com/conda-forge/unicloud-feedstock)


unicloud - Cloud utility package
=====================================================================
- **Unicloud** provides robust and intuitive tools designed to simplify interactions with AWS S3 and Google
Cloud Storage (GCS), offering developers a streamlined API for managing cloud storage operations.
- Whether you're uploading data backups, retrieving files for analysis, or managing cloud storage resources
programmatically, our package ensures a seamless and efficient experience. Built with flexibility and ease of use
in mind, it supports a wide range of operations, including file uploads, downloads, and storage management tasks,
all while maintaining high security and reliability standards.
- Ideal for developers working in cloud-native
environments, data scientists requiring reliable data storage solutions, or businesses looking to automate their
cloud storage workflows, this package aims to enhance productivity and facilitate the seamless integration of
cloud storage capabilities into Python applications.

Documentation
=============
- Full documentation is available at [GitHub Pages](https://serapeum-org.github.io/unicloud/)

Installing unicloud
===================

Installing `unicloud` from the `conda-forge` channel can be achieved by:

```
conda install -c conda-forge unicloud
```

It is possible to list all the versions of `unicloud` available on your platform with:

```
conda search unicloud --channel conda-forge
```

## Install from GitHub

to install the last development to time, you can install the library from GitHub

```
pip install git+https://github.com/serapeum-org/unicloud
```

## pip

to install the last release, you can easily use pip

```
pip install unicloud
```

to install only the Google Cloud storage part, you can use the following command :

```
pip install unicloud[gcs]
```

to install only the AWS S3 part, you can use the following command :

```
pip install unicloud[s3]
```

to indtall all the dependencies, you can use the following command :

```
pip install unicloud[all]
```

Quick start
===========

```
  >>> import unicloud
```

[other code samples](https://serapeum-org.github.io/unicloud/)
