pcloud-python-sdk 1.0.3

Python client for the pCloud API.

pcloud-python-sdk

Dropbox-style Python SDK for the pCloud API.

Install

pip install pcloud-python-sdk

Quickstart

from pcloud import PCloud, PCloudOAuth2Flow

# 1) OAuth flow (web) — paste the code back
flow = PCloudOAuth2Flow(app_key, app_secret,
                        redirect_uri=None,  # EXACT match
                        location="EU")

auth_url = flow.start(state="xyz")
print("Open:", auth_url)  # sanity check the redirect_uri value shown

code = input("Paste the code from the URL bar: ").strip()
tok = flow.finish(code)

pc = PCloud(access_token=tok.access_token, location="EU")
print(pc.files.list_folder(folderid=0))

Upload with progress

from pcloud import PCloud
pc = PCloud(access_token="...")

def on_progress(done, total):
    if total:
        pct = 100.0 * done / total
        print(f"Uploaded {done}/{total} bytes ({pct:.1f}%)")
    else:
        print(f"Uploaded {done} bytes")

pc.files.files_upload("local.jpg", folderid=0, on_progress=on_progress)

Download with progress

from pcloud import PCloud
pc = PCloud(access_token="...")

def on_progress(done, total):
    if total:
        pct = 100.0 * done / total
        print(f"Downloaded {done}/{total} bytes ({pct:.1f}%)")
    else:
        print(f"Downloaded {done} bytes")

pc.files.files_download(fileid=12345, dest_path="./local.jpg", on_progress=on_progress)

API surface

• pcloud.PCloud: top-level client
• pcloud.PCloudOAuth2Flow / pcloud.PCloudOAuth2FlowNoRedirect: OAuth helpers
• client.files.*:
  • list_folder, create_folder, delete_file
  • files_upload, files_download, get_file_link

This mirrors the ergonomics of the Dropbox Python SDK while using pCloud endpoints under the hood.

Development

python -m pip install -U pip
pip install -e .
pip install pytest ruff mypy
pytest -q

Releasing

• Create a PyPI project & token.
• Locally:

  python -m pip install -U build twine
  python -m build
  twine check dist/*
  twine upload dist/*
  

• Or tag vX.Y.Z and let GitHub Actions publish (see .github/workflows/release.yml).

License

MIT