Metadata-Version: 2.4
Name: cesiumcloud
Version: 0.1.0
Summary: CesiumCloud cloud storage Python SDK and command-line client
Author: CesiumCloud
Project-URL: Homepage, https://cloud.cesiummc.space/
Project-URL: Documentation, https://api.cesiummc.space/docs
Keywords: cesiumcloud,cloud,storage,backup
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Topic :: Internet
Classifier: Topic :: System :: Archiving :: Backup
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# CesiumCloud for Python

CesiumCloud cloud storage client for Python 3.10+.

## Installation

Install the latest version from PyPI:

    python -m pip install cesiumcloud

Or install the official wheel directly:

    python3 -m pip install https://cloud.cesiummc.space/clients/cesiumcloud-0.1.0-py3-none-any.whl

## Command-line use

    python -m cesiumcloud authenticate
    python -m cesiumcloud upload "/home/user/Documents"
    python -m cesiumcloud upload "/home/user/dogimages.zip"
    python -m cesiumcloud download "/home/user/Restored"
    python -m cesiumcloud whoami

The cesiumcloud-python command is equivalent.

## Python SDK

    from cesiumcloud import CesiumCloudClient

    client = CesiumCloudClient()
    client.authenticate()
    client.upload("/home/user/dogimages.zip")
    files = client.list_files()
    print([file["name"] for file in files])
    client.download("/home/user/Restored")

Authentication uses your CesiumCloud account without copying an API key.
The Python implementation requires no Node.js runtime or third-party Python dependencies.

## Current limitations

Data is streamed directly from local files. The Python client does not yet maintain
restart-safe checkpoints across processes. Existing destination files are not
silently overwritten. Keep an independent backup of important data.

## Access management

Revoke credentials from the CesiumCloud dashboard. The logout command removes local credentials only.

## Existing accounts

CesiumCloud connects to the existing API and continues reading legacy ~/.tencloud/credentials.json for backwards compatibility. Existing TenCloud package installations are not modified.
