Skip to main content

Suning biu smart home SMS login and session client

Project description

python-xiaobiu

Python client for Suning smart home SMS login and session management.

Used by the ha-suning Home Assistant custom integration.

Install

pip install python-xiaobiu

Usage

from xiaobiu import CaptchaRequiredError, SuningSmartHomeClient

client = SuningSmartHomeClient(state_path=".suning-session.json")

try:
    client.send_sms_code("13800000000")
except CaptchaRequiredError as error:
    print(error.risk_type, error.sms_ticket)

client.login_with_sms_code(phone_number="13800000000", sms_code="123456")
print(client.list_family_infos())

CLI

# Interactive login
xiaobiucli login --phone 13800000000 --state-file .suning-session.json

# Send SMS only
xiaobiucli send-sms --phone 13800000000 --state-file .suning-session.json

# Check session
xiaobiucli check --state-file .suning-session.json

# List families / devices
xiaobiucli families --state-file .suning-session.json
xiaobiucli devices --family-id 37790 --state-file .suning-session.json

Requirements

  • Python >= 3.14
  • cryptography, pydantic, requests

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python_xiaobiu-0.1.0.tar.gz (43.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

python_xiaobiu-0.1.0-py3-none-any.whl (22.1 kB view details)

Uploaded Python 3

File details

Details for the file python_xiaobiu-0.1.0.tar.gz.

File metadata

  • Download URL: python_xiaobiu-0.1.0.tar.gz
  • Upload date:
  • Size: 43.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for python_xiaobiu-0.1.0.tar.gz
Algorithm Hash digest
SHA256 ffdb75cea440d0a8583675a56b210ef2e9543c7c40ce9f5702f8f22def6d2932
MD5 d93cb386ff5b51ad70c86a330effe50f
BLAKE2b-256 0815c370dbe0721b59fd43802ad96bbb1bb82ac59c1541747feba99f120981b3

See more details on using hashes here.

Provenance

The following attestation bundles were made for python_xiaobiu-0.1.0.tar.gz:

Publisher: python-publish.yml on FaintGhost/python-xiaobiu

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file python_xiaobiu-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: python_xiaobiu-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 22.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for python_xiaobiu-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b35069dbf2b577b6ed26eaf682a17ce69cae12cdbc3183aaa024b2a55687ae36
MD5 8578e53e1e9bc9a5fcd7587e8cb4d604
BLAKE2b-256 91a7bf7e05c48d0bf505e0ed218a2595ad30afbbd6f0b0473fcbcf983fa43a46

See more details on using hashes here.

Provenance

The following attestation bundles were made for python_xiaobiu-0.1.0-py3-none-any.whl:

Publisher: python-publish.yml on FaintGhost/python-xiaobiu

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page