pxcloud

pxcloud is a Python client for PX Cloud HTTP APIs. It currently exposes list_devices, find_device_by_name, get_sessions, get_sgts, apply_anc_policy_by_mac, and clear_anc_policy_by_mac through Requests-based synchronous and aiohttp-based asynchronous clients.

Installation

python -m pip install pxcloud

Usage

Set PXCLOUD_TENANT_ID and PXCLOUD_API_KEY. Optionally set PXCLOUD_BASE_URL and PXCLOUD_TIMEOUT.

from pxcloud import ClientConfig, PxCloudClient

with PxCloudClient(ClientConfig.from_env()) as client:
    sessions = client.get_sessions("device-id")

The async client has the same API:

from pxcloud import AsyncPxCloudClient, ClientConfig

async with AsyncPxCloudClient(ClientConfig.from_env()) as client:
    sessions = await client.get_sessions("device-id")

Enable HTTP request/response logging with standard Python logging:

import logging
logging.basicConfig(level=logging.DEBUG)

API keys are redacted from logged headers. Response bodies are logged at DEBUG.

Development

Run the same test command used by CI:

python -m pip install --upgrade pip hatch
hatch run test

Build the wheel and source distribution:

hatch build

Versions come from Git tags such as v0.1.0 via hatch-vcs. GitHub Actions tests Python 3.10–3.14, builds distributions, and publishes to PyPI for v* tags using PyPI Trusted Publishing.