yarno 0.2.0__tar.gz

yarno-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 alfa
+
+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.

yarno-0.2.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: yarno
+Version: 0.2.0
+Summary: write bots for we.yarno — cards, inline forms, server-counted polls, live values, voice
+Author: alfa
+License-Expression: MIT
+Project-URL: docs, https://dev.we.yarno.lol/docs
+Project-URL: source, https://github.com/alfaoz/yarno-sdk
+Keywords: yarno,bot,chat,socketio
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Communications :: Chat
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-socketio[asyncio_client]>=5.11
+Requires-Dist: aiohttp>=3.9
+Provides-Extra: voice
+Requires-Dist: livekit>=0.17; extra == "voice"
+Dynamic: license-file
+
+# yarno
+
+write bots for [we.yarno](https://we.yarno.lol) — the invite-only
+servers/channels/voice app.
+
+```bash
+pip install yarno
+```
+
+the shortest complete bot:
+
+```python
+from yarno import Bot
+
+bot = Bot()                    # reads $YARNO_TOKEN
+
+@bot.command("hi", "says hi")
+async def hi(ctx):
+    return f"hi {ctx.username}"
+
+bot.run()
+```
+
+no intents, no command tree, no `sync()` step, no 3-second deadline. your bot
+holds a live socket to the instance, so the decorator *is* the registration
+and a handler can take as long as it needs.
+
+## what you get
+
+- **cards** — compose rows, columns, progress bars, images, buttons instead
+  of filling in an embed
+- **inline forms** — `ui.input` / `ui.select` / `ui.toggle` / `ui.slider`
+  live in the card, in the channel; any click submits the whole form as
+  `ctx.values`. no modals.
+- **polls that outlive you** — `ui.button(collect="v:yes")` is counted by the
+  server, so votes land while your process is down; read them back with
+  `bot.tallies()`
+- **live values** — `ui.ticker` / `ui.bar(rate=...)` advance on every
+  viewer's screen; you push state changes, not frames
+- **docked cards** — pin one card above the channel's scroll (now playing,
+  scoreboards, countdowns)
+- **autocomplete** — suggest argument values as someone types, over your
+  already-open socket
+- **dms, files, reactions, avatars, voice** — `@bot.on_message`,
+  `send(files=[...])`, `bot.react()`, `bot.set_avatar()`, and
+  `bot.voice_join()` with the `yarno[voice]` extra
+- **buttons that survive restarts** — per-message state lives on the server
+  and rides back with every click
+
+## privacy, stated up front
+
+a bot sees nothing by default: commands aimed at it, clicks on its own
+cards, and dms it's part of. it does **not** receive channel messages, and
+there is no intent to flip on. the read apis hold the same line.
+
+## docs
+
+- [quickstart](https://dev.we.yarno.lol/docs/quickstart) — token to working
+  command in about two minutes
+- [cards & components](https://dev.we.yarno.lol/docs/cards)
+- [the full sdk reference](https://dev.we.yarno.lol/docs/sdk)
+- [wire protocol](https://dev.we.yarno.lol/docs/protocol) — for writing a
+  bot in another language
+
+examples live in [`examples/`](examples/): `pingpong.py` is the core loop,
+`lunchbot.py` is forms + polls + autocomplete + a docked countdown.
+
+tokens come from the [dev console](https://dev.we.yarno.lol). we.yarno is
+invite-only; the sdk is public so bots can be written for it.

yarno-0.2.0/README.md

@@ -0,0 +1,69 @@
+# yarno
+
+write bots for [we.yarno](https://we.yarno.lol) — the invite-only
+servers/channels/voice app.
+
+```bash
+pip install yarno
+```
+
+the shortest complete bot:
+
+```python
+from yarno import Bot
+
+bot = Bot()                    # reads $YARNO_TOKEN
+
+@bot.command("hi", "says hi")
+async def hi(ctx):
+    return f"hi {ctx.username}"
+
+bot.run()
+```
+
+no intents, no command tree, no `sync()` step, no 3-second deadline. your bot
+holds a live socket to the instance, so the decorator *is* the registration
+and a handler can take as long as it needs.
+
+## what you get
+
+- **cards** — compose rows, columns, progress bars, images, buttons instead
+  of filling in an embed
+- **inline forms** — `ui.input` / `ui.select` / `ui.toggle` / `ui.slider`
+  live in the card, in the channel; any click submits the whole form as
+  `ctx.values`. no modals.
+- **polls that outlive you** — `ui.button(collect="v:yes")` is counted by the
+  server, so votes land while your process is down; read them back with
+  `bot.tallies()`
+- **live values** — `ui.ticker` / `ui.bar(rate=...)` advance on every
+  viewer's screen; you push state changes, not frames
+- **docked cards** — pin one card above the channel's scroll (now playing,
+  scoreboards, countdowns)
+- **autocomplete** — suggest argument values as someone types, over your
+  already-open socket
+- **dms, files, reactions, avatars, voice** — `@bot.on_message`,
+  `send(files=[...])`, `bot.react()`, `bot.set_avatar()`, and
+  `bot.voice_join()` with the `yarno[voice]` extra
+- **buttons that survive restarts** — per-message state lives on the server
+  and rides back with every click
+
+## privacy, stated up front
+
+a bot sees nothing by default: commands aimed at it, clicks on its own
+cards, and dms it's part of. it does **not** receive channel messages, and
+there is no intent to flip on. the read apis hold the same line.
+
+## docs
+
+- [quickstart](https://dev.we.yarno.lol/docs/quickstart) — token to working
+  command in about two minutes
+- [cards & components](https://dev.we.yarno.lol/docs/cards)
+- [the full sdk reference](https://dev.we.yarno.lol/docs/sdk)
+- [wire protocol](https://dev.we.yarno.lol/docs/protocol) — for writing a
+  bot in another language
+
+examples live in [`examples/`](examples/): `pingpong.py` is the core loop,
+`lunchbot.py` is forms + polls + autocomplete + a docked countdown.
+
+tokens come from the [dev console](https://dev.we.yarno.lol). we.yarno is
+invite-only; the sdk is public so bots can be written for it.

yarno-0.2.0/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "yarno"
+version = "0.2.0"
+description = "write bots for we.yarno — cards, inline forms, server-counted polls, live values, voice"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "alfa" }]
+requires-python = ">=3.10"
+dependencies = ["python-socketio[asyncio_client]>=5.11", "aiohttp>=3.9"]
+keywords = ["yarno", "bot", "chat", "socketio"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Chat",
+    "Framework :: AsyncIO",
+]
+
+[project.optional-dependencies]
+voice = ["livekit>=0.17"]
+
+[project.urls]
+docs = "https://dev.we.yarno.lol/docs"
+source = "https://github.com/alfaoz/yarno-sdk"
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+packages = ["yarno"]

yarno-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

yarno-0.2.0/yarno/__init__.py

@@ -0,0 +1,20 @@
+"""yarno — write bots for we.yarno.
+
+    from yarno import Bot, ui
+
+    bot = Bot()
+
+    @bot.command("hi", "says hi")
+    async def hi(ctx):
+        return "hi"
+
+    bot.run()
+
+Get a token at https://dev.we.yarno.lol, docs at https://dev.we.yarno.lol/docs.
+"""
+
+from . import ui
+from .bot import Bot, CommandError, Context, RateLimited, mention
+
+__all__ = ["Bot", "Context", "CommandError", "RateLimited", "mention", "ui"]
+__version__ = "0.2.0"