rootpy-client 1.31.1__tar.gz

rootpy_client-1.31.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 solluws
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rootpy_client-1.31.1/MANIFEST.in

@@ -0,0 +1,19 @@
+# The sdist is the library plus the two documents a reader needs offline.
+# Everything else in this repository -- the test suite, the examples and the
+# CI configuration -- is repository material and is deliberately left out of
+# the distribution.
+include LICENSE README.md
+
+# The protocol registries. Without them the package installs and every schema
+# lookup raises, so this line is load-bearing in the sdist exactly as
+# [tool.setuptools.package-data] is in the wheel.
+recursive-include rootpy/data *.json
+
+# PEP 561 marker for the "Typing :: Typed" classifier.
+include rootpy/py.typed
+
+prune tests
+prune examples
+prune .github
+
+global-exclude *.py[cod] __pycache__/* *.log tokens*.txt *.token .env

rootpy_client-1.31.1/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: rootpy-client
+Version: 1.31.1
+Summary: Async Python client for the Root chat platform
+Author: solluws
+License-Expression: MIT
+Project-URL: Homepage, https://rootpy.gay
+Project-URL: Documentation, https://rootpy.gay
+Project-URL: Repository, https://github.com/solluws/rap-p-ers
+Project-URL: Issues, https://github.com/solluws/rap-p-ers/issues
+Keywords: root,rootapp,chat,async,asyncio,grpc-web,websocket,bot,api-client
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Internet
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx[http2]>=0.27
+Requires-Dist: websockets>=12.0
+Requires-Dist: emoji>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.26; extra == "dev"
+Requires-Dist: httpx[socks]>=0.27; extra == "dev"
+Provides-Extra: voice
+Requires-Dist: av>=15.1; extra == "voice"
+Requires-Dist: aiortc>=1.13; extra == "voice"
+Requires-Dist: imageio-ffmpeg<1,>=0.5; extra == "voice"
+Requires-Dist: playwright>=1.44; extra == "voice"
+Dynamic: license-file
+
+# rootpy-client
+
+[![tests](https://github.com/solluws/rap-p-ers/actions/workflows/tests.yml/badge.svg)](https://github.com/solluws/rap-p-ers/actions/workflows/tests.yml)
+[![python](https://img.shields.io/badge/python-3.10%2B-blue)](https://pypi.org/project/rootpy-client/)
+[![license](https://img.shields.io/badge/license-MIT-green)](https://github.com/solluws/rap-p-ers/blob/main/LICENSE)
+
+An async Python client for the [Root](https://rootapp.com) chat platform. It
+drives one account — yours — from a script or a bot, and covers messaging,
+communities, channels, roles, direct messages, friends, presence, voice
+signalling and the real-time gateway.
+
+Unofficial. Not affiliated with Root, and not endorsed by them.
+
+**Guides, examples and the full API reference: <https://rootpy.gay>**
+
+## Install
+
+```bash
+pip install rootpy-client
+```
+
+You install `rootpy-client` and you import `rootpy`. The two names differ
+because an unrelated project already holds `rootpy` on PyPI. This is not that
+project.
+
+Python 3.10 or later. Playing audio into a voice call needs an opt-in extra:
+`pip install "rootpy-client[voice]"`.
+
+## Use it
+
+```python
+import asyncio
+import os
+
+from rootpy import RootClient
+
+
+async def main():
+    client = RootClient(token=os.environ["ROOT_TOKEN"])
+    await client.login_token()
+
+    await client.messages.send(CHANNEL_ID, "hello", community_id=COMMUNITY_ID)
+
+    await client.close()
+
+
+asyncio.run(main())
+```
+
+Receiving needs the gateway, and a community delivers nothing until you attach
+to it:
+
+```python
+@client.event
+async def on_message(event):
+    print(event.message.content)
+
+
+async with client.community.held(COMMUNITY_ID):
+    await client.connect()
+    await client.wait_until_ready()
+    await asyncio.sleep(3600)
+```
+
+## What is in it
+
+- **Messages** — send, reply in a thread, edit, delete, react, pin, and
+  paginated history.
+- **Communities** — create, join by invite, channels and channel groups, roles
+  and permissions, members, invites, emoji and assets.
+- **Discovery** — search the public directory, and list your own community.
+- **Direct messages** — conversations, group conversations, friends and blocks.
+- **Gateway** — a websocket connection with typed events, `wait_for()` and
+  reconnection.
+- **Voice** — call signalling, mute and deafen, and audio playback behind the
+  `[voice]` extra.
+- **Auth** — token login, email and password login, and signup.
+
+## Notes worth knowing before you start
+
+- **Membership is not a subscription.** Until you call
+  `client.community.attach(id)`, the hub sends no packet for that community at
+  all, while direct messages and mentions keep arriving on the same socket.
+  That asymmetry is what a broken listener looks like.
+- **The gateway is a resync cycle, not a persistent stream.** The hub sends a
+  batch, closes with code 1000, and expects a reconnect. That is normal. An
+  attach does not survive it, so hold it with `client.community.held(id)`.
+- **Presence is two calls, and the lower one wins.** Others see
+  `min(ceiling, device)`. Both halves succeed on their own, so setting only the
+  ceiling leaves your account invisible to everybody and reports success.
+  `client.set_presence(...)` sets both.
+
+## Develop
+
+```bash
+git clone https://github.com/solluws/rap-p-ers
+cd rap-p-ers
+pip install -e ".[dev]"
+python -m pytest -q
+```
+
+The suite is offline. It pins the wire format, so a change to an endpoint, a
+field number or a default fails a test rather than a live request.
+
+Pull requests are welcome. Keep the tests green, and add one for whatever you
+change.
+
+## Licence
+
+MIT. See [LICENSE](https://github.com/solluws/rap-p-ers/blob/main/LICENSE).
+
+Use this on accounts you control, and read Root's terms before you automate
+anything on their service.

rootpy_client-1.31.1/README.md

@@ -0,0 +1,113 @@
+# rootpy-client
+
+[![tests](https://github.com/solluws/rap-p-ers/actions/workflows/tests.yml/badge.svg)](https://github.com/solluws/rap-p-ers/actions/workflows/tests.yml)
+[![python](https://img.shields.io/badge/python-3.10%2B-blue)](https://pypi.org/project/rootpy-client/)
+[![license](https://img.shields.io/badge/license-MIT-green)](https://github.com/solluws/rap-p-ers/blob/main/LICENSE)
+
+An async Python client for the [Root](https://rootapp.com) chat platform. It
+drives one account — yours — from a script or a bot, and covers messaging,
+communities, channels, roles, direct messages, friends, presence, voice
+signalling and the real-time gateway.
+
+Unofficial. Not affiliated with Root, and not endorsed by them.
+
+**Guides, examples and the full API reference: <https://rootpy.gay>**
+
+## Install
+
+```bash
+pip install rootpy-client
+```
+
+You install `rootpy-client` and you import `rootpy`. The two names differ
+because an unrelated project already holds `rootpy` on PyPI. This is not that
+project.
+
+Python 3.10 or later. Playing audio into a voice call needs an opt-in extra:
+`pip install "rootpy-client[voice]"`.
+
+## Use it
+
+```python
+import asyncio
+import os
+
+from rootpy import RootClient
+
+
+async def main():
+    client = RootClient(token=os.environ["ROOT_TOKEN"])
+    await client.login_token()
+
+    await client.messages.send(CHANNEL_ID, "hello", community_id=COMMUNITY_ID)
+
+    await client.close()
+
+
+asyncio.run(main())
+```
+
+Receiving needs the gateway, and a community delivers nothing until you attach
+to it:
+
+```python
+@client.event
+async def on_message(event):
+    print(event.message.content)
+
+
+async with client.community.held(COMMUNITY_ID):
+    await client.connect()
+    await client.wait_until_ready()
+    await asyncio.sleep(3600)
+```
+
+## What is in it
+
+- **Messages** — send, reply in a thread, edit, delete, react, pin, and
+  paginated history.
+- **Communities** — create, join by invite, channels and channel groups, roles
+  and permissions, members, invites, emoji and assets.
+- **Discovery** — search the public directory, and list your own community.
+- **Direct messages** — conversations, group conversations, friends and blocks.
+- **Gateway** — a websocket connection with typed events, `wait_for()` and
+  reconnection.
+- **Voice** — call signalling, mute and deafen, and audio playback behind the
+  `[voice]` extra.
+- **Auth** — token login, email and password login, and signup.
+
+## Notes worth knowing before you start
+
+- **Membership is not a subscription.** Until you call
+  `client.community.attach(id)`, the hub sends no packet for that community at
+  all, while direct messages and mentions keep arriving on the same socket.
+  That asymmetry is what a broken listener looks like.
+- **The gateway is a resync cycle, not a persistent stream.** The hub sends a
+  batch, closes with code 1000, and expects a reconnect. That is normal. An
+  attach does not survive it, so hold it with `client.community.held(id)`.
+- **Presence is two calls, and the lower one wins.** Others see
+  `min(ceiling, device)`. Both halves succeed on their own, so setting only the
+  ceiling leaves your account invisible to everybody and reports success.
+  `client.set_presence(...)` sets both.
+
+## Develop
+
+```bash
+git clone https://github.com/solluws/rap-p-ers
+cd rap-p-ers
+pip install -e ".[dev]"
+python -m pytest -q
+```
+
+The suite is offline. It pins the wire format, so a change to an endpoint, a
+field number or a default fails a test rather than a live request.
+
+Pull requests are welcome. Keep the tests green, and add one for whatever you
+change.
+
+## Licence
+
+MIT. See [LICENSE](https://github.com/solluws/rap-p-ers/blob/main/LICENSE).
+
+Use this on accounts you control, and read Root's terms before you automate
+anything on their service.

rootpy_client-1.31.1/pyproject.toml

@@ -0,0 +1,90 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rootpy-client"
+version = "1.31.1"
+description = "Async Python client for the Root chat platform"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "solluws" }]
+requires-python = ">=3.10"
+keywords = [
+    "root",
+    "rootapp",
+    "chat",
+    "async",
+    "asyncio",
+    "grpc-web",
+    "websocket",
+    "bot",
+    "api-client",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Framework :: AsyncIO",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Communications :: Chat",
+    "Topic :: Internet",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "httpx[http2]>=0.27",
+    "websockets>=12.0",
+    # Reactions are a core verb, and Root addresses every reaction by
+    # shortcode. Without this, rootpy/emoji.py falls back to a 20-entry table
+    # and refuses ordinary emoji -- a rocket and a pair of eyes both raised
+    # ValueError on a stock install. Pure Python, no transitive dependencies.
+    "emoji>=2.0",
+]
+
+[project.urls]
+Homepage = "https://rootpy.gay"
+Documentation = "https://rootpy.gay"
+Repository = "https://github.com/solluws/rap-p-ers"
+Issues = "https://github.com/solluws/rap-p-ers/issues"
+
+[project.optional-dependencies]
+# httpx[socks] is a test requirement, not a runtime one. SOCKS support stays
+# optional for users. The proxy tests build a real httpx.AsyncClient with a
+# socks5h:// URL, and httpx needs socksio for that scheme.
+dev = ["pytest>=8.0", "pytest-asyncio>=0.26", "httpx[socks]>=0.27"]
+# Voice / WebRTC. Never installed automatically -- rootpy raises
+# MediaDependencyMissing naming this extra instead of shelling out to pip.
+voice = [
+    "av>=15.1",
+    "aiortc>=1.13",
+    "imageio-ffmpeg>=0.5,<1",
+    "playwright>=1.44",
+]
+
+[tool.setuptools.packages.find]
+include = ["rootpy*"]
+# examples/ lives at the repo root; it is documentation, not shipped code.
+exclude = ["rootpy.examples*", "tests*"]
+
+[tool.setuptools.package-data]
+# The protocol registries and the PEP 561 marker. Without the JSON the wheel
+# installs but every schema lookup raises at runtime.
+rootpy = ["data/*.json", "py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+# Session-scoped async fixtures and tests must share one event loop; with the
+# default function scope the first test to finish closes the loop the fixtures
+# were created on.
+asyncio_default_fixture_loop_scope = "session"
+asyncio_default_test_loop_scope = "session"