sillo-wire 0.1.0.dev1__tar.gz → 1.0.0__tar.gz

{sillo_wire-0.1.0.dev1 → sillo_wire-1.0.0}/.github/workflows/ci.yml

@@ -27,7 +27,7 @@ jobs:
           pip install pytest pytest-asyncio pytest-cov ruff mypy
 
       - name: Lint
-        run: ruff check sillo_wire tests _sillo_wire_bootstrap.py
+        run: ruff check sillo_wire tests
 
       - name: Types
         run: mypy sillo_wire
@@ -35,19 +35,28 @@ jobs:
       - name: Install the package
         run: pip install -e .
 
-      # The `.pth` only fires for a real install, so the alias is checked
-      # against a built wheel rather than the editable checkout.
-      - name: Check the sillo.wire alias against a real install
+      # Checked against a built wheel rather than the editable checkout: an
+      # editable install can import a package the wheel does not actually ship.
+      - name: Check a built wheel installs and imports
         run: |
           pip install build && python -m build --wheel -o /tmp/w .
           python -m venv /tmp/v && /tmp/v/bin/pip install -q sillo-framework /tmp/w/*.whl mypy
           /tmp/v/bin/python -c "
-          import sillo, sillo.wire, sillo_wire, os
-          assert sillo.wire is sillo_wire
+          import os, sillo, sillo_wire
+          from sillo_wire import Hub
+          # The package is top-level and adds nothing to the framework's own
+          # directory; it used to ship a .pth that aliased sillo.wire onto it.
           assert 'wire' not in os.listdir(os.path.dirname(sillo.__file__)), 'wrote into sillo/'
-          print('alias ok, sillo/ untouched')
+          try:
+              import sillo.wire
+          except ImportError:
+              pass
+          else:
+              raise AssertionError('sillo.wire still resolves; the alias was removed')
+          print('sillo_wire imports, sillo/ untouched, no alias')
           "
-          printf 'from sillo.wire import Hub\nh: Hub = Hub()\n' > /tmp/tc.py
+          # Types come from the package's own inline annotations now, not stubs.
+          printf 'from sillo_wire import Hub\nh: Hub = Hub()\n' > /tmp/tc.py
           /tmp/v/bin/python -m mypy /tmp/tc.py
 
       - name: Test

{sillo_wire-0.1.0.dev1 → sillo_wire-1.0.0}/.github/workflows/release.yml

@@ -77,9 +77,10 @@ jobs:
       - name: Build the package
         run: uv build
 
-      # The whole point of this package's layout: the wheel adds a top-level
-      # `sillo_wire` plus the `.pth`/bootstrap at the site-packages root, and
-      # it must never write into the framework's own `sillo/` directory.
+      # The wheel adds a top-level `sillo_wire` and nothing else; it must never
+      # write into the framework's own `sillo/` directory. Two distributions
+      # sharing one package directory goes wrong in both directions, which is
+      # why this is asserted rather than assumed.
       - name: The wheel must stay out of sillo/
         run: |
           python - <<'PY'

{sillo_wire-0.1.0.dev1 → sillo_wire-1.0.0}/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## Unreleased
+
+## [1.0.0] - 2026-09-26
+
+Stable Sillo 1.0 WebSocket and realtime transport release.
+
+## [1.0.0a1] - 2026-09-13
+
+First alpha, released alongside `sillo-framework` 1.0.0a1. Install with
+`pip install --pre sillo-wire==1.0.0a1`.
+
+An alpha: this is what 1.0 is expected to look like, but the API is not frozen
+yet and may still change before `1.0.0`.
+
+### Removed
+
+- **The `sillo.wire` import alias.** `sillo_wire` is now the only import path:
+
+  ```python
+  from sillo_wire import Hub, Peer     # was: from sillo.wire import ...
+  ```
+
+  The alias was a meta-path finder registered by a `.pth` at interpreter
+  startup, plus PEP 561 stubs under `sillo-stubs/` to serve type checkers,
+  which never run import hooks. It read as part of the framework, but it cost a
+  `.pth` executing on every interpreter start in every environment the package
+  was installed in, a second set of stubs to keep in step with the real
+  package, and a name that static analysis only resolved because a second set
+  of files said so. A plain top-level package needs none of that.
+
+  `_sillo_wire_bootstrap.py`, `sillo_wire.pth` and `sillo-stubs/` are gone, and
+  so are the `force-include` blocks that shipped them. Inline types in
+  `sillo_wire` are now the single source of truth for type checkers.
+
 ## 0.1.0.dev1
 
 Development pre-release for testing. Install with

{sillo_wire-0.1.0.dev1 → sillo_wire-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sillo-wire
-Version: 0.1.0.dev1
+Version: 1.0.0
 Summary: Rooms, presence and fan-out for Sillo WebSockets — bounded queues, replayable backlog, no global state.
 Project-URL: Homepage, https://sillo.build
 Project-URL: Documentation, https://docs.sillo.build/packages/wire/
@@ -9,7 +9,7 @@ Author-email: Chidebele Dunamis <techwithdunamix@gmail.com>
 License-Expression: BSD-3-Clause
 License-File: LICENSE
 Keywords: asgi,broadcast,presence,pubsub,realtime,sillo,websocket
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Framework :: AsyncIO
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: BSD License
@@ -21,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
-Requires-Dist: sillo-framework>=0.3
+Requires-Dist: sillo-framework>=1.0.0
 Provides-Extra: dev
 Requires-Dist: mypy>=1.11; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
@@ -38,11 +38,11 @@ Rooms, presence and fan-out for [Sillo](https://sillo.build) WebSockets.
 pip install sillo-wire
 ```
 
-Installs as `sillo-wire`, imports as `sillo.wire`.
+Installs as `sillo-wire`, imports as `sillo_wire`.
 
 ```python
 from sillo import SilloApp
-from sillo.wire import Hub, Peer
+from sillo_wire import Hub, Peer
 
 app = SilloApp()
 hub = Hub()
@@ -98,7 +98,7 @@ await hub.replay(peer, "lobby", since=last_seq_the_client_saw)
 When a peer's queue fills, what happens is a choice, not a default:
 
 ```python
-from sillo.wire import Overflow, Peer
+from sillo_wire import Overflow, Peer
 
 Peer(socket, overflow=Overflow.DROP_OLDEST)   # keep current — prices, cursors
 Peer(socket, overflow=Overflow.DROP_NEWEST)   # keep order — reconcile later
@@ -130,7 +130,7 @@ joins the rooms, pumps messages, and guarantees the peer is removed from every
 room when the connection ends — including when a hook raises.
 
 ```python
-from sillo.wire import Hub, RoomConsumer
+from sillo_wire import Hub, RoomConsumer
 
 hub = Hub()
 
@@ -154,7 +154,7 @@ app.add_ws_route(path="/ws/{room}", handler=Chat.as_handler())
 Retention is per room and capped by payload bytes, evicting oldest first:
 
 ```python
-from sillo.wire import Hub, MemoryBacklog, NullBacklog
+from sillo_wire import Hub, MemoryBacklog, NullBacklog
 
 Hub(backlog=MemoryBacklog(capacity_bytes=4 * 1024 * 1024))
 Hub(backlog=NullBacklog())    # keep nothing — typing indicators, telemetry
@@ -165,10 +165,10 @@ importing anything from here.
 
 ## Testing
 
-`sillo.wire.testing` ships the piece unit tests are missing — a socket:
+`sillo_wire.testing` ships the piece unit tests are missing — a socket:
 
 ```python
-from sillo.wire import Hub, Peer
+from sillo_wire import Hub, Peer
 from sillo_wire.testing import FakeSocket, drain
 
 async def test_a_broadcast_reaches_the_room():
@@ -197,32 +197,6 @@ to reproduce against a real server and the two most worth testing.
 | `Backlog` | `MemoryBacklog` `NullBacklog`, or your own |
 | `Overflow` | `DROP_OLDEST` `DROP_NEWEST` `CLOSE` |
 
-## The two import paths
-
-`sillo.wire` and `sillo_wire` name the same objects. The code lives in the
-top-level `sillo_wire` package; `sillo.wire` is an alias, so it reads as part
-of the framework:
-
-```python
-from sillo.wire import Hub     # both of these
-from sillo_wire import Hub     # bind the same class
-```
-
-The alias is a meta-path finder registered by a `.pth` at interpreter startup —
-the only hook that runs before an `import sillo.wire` could fail. Type checkers
-never run import hooks, so they are served separately by the partial stubs in
-`sillo-stubs/` (PEP 561), which are additive: mypy resolves `sillo.wire` and
-still uses the framework's own inline types for the rest of `sillo`.
-
-Nothing is written into the framework's package directory. Shipping
-`sillo/wire/` in there would be simpler, and it is what this did first — but
-two distributions sharing one directory goes wrong in both directions.
-Installing the framework from a checkout moves where `sillo` resolves and
-orphans the copy in site-packages; removing or replacing the framework leaves
-that directory standing with no `__init__.py`, which is an override rather than
-an addition. Uninstalling either package here leaves the other exactly as it
-was.
-
 ## Working on it
 
 The alias works under an editable install too — the `.pth` is shipped by the
@@ -231,13 +205,13 @@ editable build target as well as the wheel.
 ```bash
 pip install -e ".[dev]"
 pytest --cov            # 100% required, bootstrap included
-ruff check sillo_wire tests _sillo_wire_bootstrap.py
+ruff check sillo_wire tests
 mypy sillo_wire
 ```
 
 ## Requirements
 
-Python 3.10+, `sillo-framework` 0.3 or newer. No other dependencies.
+Python 3.10+, `sillo-framework` 1.0 or newer. No other dependencies.
 
 ## Licence
 

{sillo_wire-0.1.0.dev1 → sillo_wire-1.0.0}/README.md

@@ -6,11 +6,11 @@ Rooms, presence and fan-out for [Sillo](https://sillo.build) WebSockets.
 pip install sillo-wire
 ```
 
-Installs as `sillo-wire`, imports as `sillo.wire`.
+Installs as `sillo-wire`, imports as `sillo_wire`.
 
 ```python
 from sillo import SilloApp
-from sillo.wire import Hub, Peer
+from sillo_wire import Hub, Peer
 
 app = SilloApp()
 hub = Hub()
@@ -66,7 +66,7 @@ await hub.replay(peer, "lobby", since=last_seq_the_client_saw)
 When a peer's queue fills, what happens is a choice, not a default:
 
 ```python
-from sillo.wire import Overflow, Peer
+from sillo_wire import Overflow, Peer
 
 Peer(socket, overflow=Overflow.DROP_OLDEST)   # keep current — prices, cursors
 Peer(socket, overflow=Overflow.DROP_NEWEST)   # keep order — reconcile later
@@ -98,7 +98,7 @@ joins the rooms, pumps messages, and guarantees the peer is removed from every
 room when the connection ends — including when a hook raises.
 
 ```python
-from sillo.wire import Hub, RoomConsumer
+from sillo_wire import Hub, RoomConsumer
 
 hub = Hub()
 
@@ -122,7 +122,7 @@ app.add_ws_route(path="/ws/{room}", handler=Chat.as_handler())
 Retention is per room and capped by payload bytes, evicting oldest first:
 
 ```python
-from sillo.wire import Hub, MemoryBacklog, NullBacklog
+from sillo_wire import Hub, MemoryBacklog, NullBacklog
 
 Hub(backlog=MemoryBacklog(capacity_bytes=4 * 1024 * 1024))
 Hub(backlog=NullBacklog())    # keep nothing — typing indicators, telemetry
@@ -133,10 +133,10 @@ importing anything from here.
 
 ## Testing
 
-`sillo.wire.testing` ships the piece unit tests are missing — a socket:
+`sillo_wire.testing` ships the piece unit tests are missing — a socket:
 
 ```python
-from sillo.wire import Hub, Peer
+from sillo_wire import Hub, Peer
 from sillo_wire.testing import FakeSocket, drain
 
 async def test_a_broadcast_reaches_the_room():
@@ -165,32 +165,6 @@ to reproduce against a real server and the two most worth testing.
 | `Backlog` | `MemoryBacklog` `NullBacklog`, or your own |
 | `Overflow` | `DROP_OLDEST` `DROP_NEWEST` `CLOSE` |
 
-## The two import paths
-
-`sillo.wire` and `sillo_wire` name the same objects. The code lives in the
-top-level `sillo_wire` package; `sillo.wire` is an alias, so it reads as part
-of the framework:
-
-```python
-from sillo.wire import Hub     # both of these
-from sillo_wire import Hub     # bind the same class
-```
-
-The alias is a meta-path finder registered by a `.pth` at interpreter startup —
-the only hook that runs before an `import sillo.wire` could fail. Type checkers
-never run import hooks, so they are served separately by the partial stubs in
-`sillo-stubs/` (PEP 561), which are additive: mypy resolves `sillo.wire` and
-still uses the framework's own inline types for the rest of `sillo`.
-
-Nothing is written into the framework's package directory. Shipping
-`sillo/wire/` in there would be simpler, and it is what this did first — but
-two distributions sharing one directory goes wrong in both directions.
-Installing the framework from a checkout moves where `sillo` resolves and
-orphans the copy in site-packages; removing or replacing the framework leaves
-that directory standing with no `__init__.py`, which is an override rather than
-an addition. Uninstalling either package here leaves the other exactly as it
-was.
-
 ## Working on it
 
 The alias works under an editable install too — the `.pth` is shipped by the
@@ -199,13 +173,13 @@ editable build target as well as the wheel.
 ```bash
 pip install -e ".[dev]"
 pytest --cov            # 100% required, bootstrap included
-ruff check sillo_wire tests _sillo_wire_bootstrap.py
+ruff check sillo_wire tests
 mypy sillo_wire
 ```
 
 ## Requirements
 
-Python 3.10+, `sillo-framework` 0.3 or newer. No other dependencies.
+Python 3.10+, `sillo-framework` 1.0 or newer. No other dependencies.
 
 ## Licence
 

{sillo_wire-0.1.0.dev1 → sillo_wire-1.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sillo-wire"
-version = "0.1.0.dev1"
+version = "1.0.0"
 description = "Rooms, presence and fan-out for Sillo WebSockets — bounded queues, replayable backlog, no global state."
 readme = "README.md"
 requires-python = ">=3.10"
@@ -14,7 +14,7 @@ authors = [
 ]
 keywords = ["sillo", "websocket", "realtime", "pubsub", "presence", "broadcast", "asgi"]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 5 - Production/Stable",
     "Framework :: AsyncIO",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: BSD License",
@@ -28,7 +28,7 @@ classifiers = [
 ]
 # Only the socket surface is used — WebSocketContext and the logger. No ORM,
 # no cache, no extras.
-dependencies = ["sillo-framework>=0.3"]
+dependencies = ["sillo-framework>=1.0.0"]
 
 [project.urls]
 Homepage = "https://sillo.build"
@@ -39,21 +39,7 @@ Source = "https://github.com/sillohq/wire"
 dev = ["pytest>=8.0", "pytest-asyncio>=0.24", "pytest-cov>=5.0", "ruff>=0.6", "mypy>=1.11"]
 
 [tool.hatch.build.targets.wheel]
-# `sillo-stubs` serves type checkers, which never run the import hook below.
-packages = ["sillo_wire", "sillo-stubs"]
-
-# The bootstrap and its .pth land at the site-packages root. The .pth is what
-# runs at interpreter startup and registers the `sillo.wire` alias; see
-# _sillo_wire_bootstrap.py for why the package is not shipped into `sillo/`.
-[tool.hatch.build.targets.wheel.force-include]
-"_sillo_wire_bootstrap.py" = "_sillo_wire_bootstrap.py"
-"sillo_wire.pth" = "sillo_wire.pth"
-
-# The same two files for `pip install -e .`, so the `sillo.wire` alias works in
-# a development checkout and not only from a built wheel.
-[tool.hatch.build.targets.editable.force-include]
-"_sillo_wire_bootstrap.py" = "_sillo_wire_bootstrap.py"
-"sillo_wire.pth" = "sillo_wire.pth"
+packages = ["sillo_wire"]
 
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
@@ -61,11 +47,6 @@ asyncio_default_fixture_loop_scope = "function"
 testpaths = ["tests"]
 
 [tool.coverage.run]
-# `_sillo_wire_bootstrap` is deliberately not measured. Its `.pth` imports it
-# at interpreter startup, before coverage exists, so its `def` and `class`
-# statements never run under the tracer and it reads as 65% however thoroughly
-# it is tested. tests/test_alias.py covers it; the number would be an artefact
-# of import timing rather than of testing.
 source = ["sillo_wire"]
 branch = true
 

{sillo_wire-0.1.0.dev1 → sillo_wire-1.0.0}/sillo_wire/__init__.py

@@ -38,7 +38,7 @@ from sillo_wire.hub import Hub
 from sillo_wire.peer import Peer
 from sillo_wire.policy import Overflow
 
-__version__ = "0.1.0.dev1"
+__version__ = "1.0.0"
 
 __all__ = [
     "Backlog",