Metadata-Version: 2.4
Name: InoCloudreve
Version: 0.0.3
Summary: Cloudreve api client
Author-email: Inoland <contact@inoland.net>
License-Expression: MPL-2.0
Project-URL: Homepage, https://github.com/nobandegani/InoCloudreve
Project-URL: Issues, https://github.com/nobandegani/InoCloudreve/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx
Dynamic: license-file

# Cloudreve Python Client

An **async** Python client for the [Cloudreve API](https://github.com/cloudreve/).  
Supports authentication, file operations, token management, and utilities—built on [httpx](https://www.python-httpx.org/) and [aiofiles](https://github.com/Tinche/aiofiles).

---

## Features

- **Health check** (`ping`)  
- **Authentication**  
  - `password_sign_in(email, password, ...)`  
  - `refresh_token(token)`  
  - `is_token_valid()` / `validate_token()`  
- **File operations**  
  - `list_files(uri, page, page_size, …)`  
  - `get_file_info(file_uri, file_id, …)`  
  - `get_download_url(uris, download, archive, …)`  
  - `update_file_content(file_uri, content, previous)`  
- **Download & save**  
  - `save_url_as_file(url, save_dir, filename, extension, overwrite)`  
- **Utilities**  
  - `read_file_as_bytes(path)`

---

## Installation

```bash
# From PyPI (if published)
pip install cloudreve-client

# Or install in editable mode from your local clone:
git clone https://github.com/nobandegani/InoCloudreve.git
cd InoCloudreve
pip install -e .
```
---

## License
Mozilla Public License Version 2.0
