02_list_residential_subusers.py

"""
List residential sub-users for both proxy types.

Each sub-user has a `proxy_password` that you use to authenticate against
the residential relays. The username (with country/region/city targeting)
is composed client-side; see 04_generate_residential_proxies.py.
"""
from proxyshard import ProxyshardClient


def fmt_gb(bytes_: int) -> str:
    return f"{bytes_ / 1024 ** 3:.2f} GB"


def main() -> None:
    client = ProxyshardClient()

    for proxy_type in ("standart", "premium"):
        users = client.residential_subusers(proxy_type=proxy_type, limit=20)
        print(f"\n=== {proxy_type.upper()} ({len(users)} sub-users) ===")
        for u in users:
            spent = fmt_gb(u["data_spent"])
            total = fmt_gb(u["data"])
            print(
                f"  id={u['user_id']}  name={u['first_name']!r:<20}  "
                f"used {spent} / {total}"
            )


if __name__ == "__main__":
    main()