Skip to content

RELEASE.md

Latest commit

 

History

History
76 lines (60 loc) · 3.11 KB

RELEASE.md

File metadata and controls

76 lines (60 loc) · 3.11 KB
Raw
weft

Releases

What changed in each version of Weft, newest first.

Keeping this file. A change someone using Weft would notice gets a line under Unreleased in the commit that makes it. When a version is cut, that section is renamed to the version and its date, and a new empty Unreleased section goes above it.

Distribution name: weft-server. Import package weft, CLI weft.

Unreleased

The tree on master for the first PyPI release (weft-server 0.1.0). Tag v0.1.0 to publish.

Added

  • ASGI 3.0 HTTP (spec 2.4) on Tokio, driven from asyncio.select(). Native send / receive vectorcall objects, a copied prototype scope, interned keys, and a pre-completed awaitable when the socket is ready.
  • HTTP/1.1: keep-alive, pipelining, chunked transfer both ways, Expect: 100-continue, HEAD/204/304, smuggling checks, header timeouts, a head size limit, graceful drain.
  • WebSocket: handshake, framing, fragmentation, ping/pong, limits, queue backpressure, permessage-deflate.
  • WSGI (PEP 3333): protocol detection, native environ and start_response (including write()), streamed iterables, wsgi.file_wrapper, --wsgi-threads.
  • HTTP/2 over TLS (ALPN h2) and cleartext prior knowledge.
  • HTTP/3 over QUIC (--http3, --quic-port) and WebTransport as ASGI webtransport.*. Incoming streams and datagrams; CONNECT accept/refuse. weft.webtransport.WebTransportSession and weft.contrib (Starlette / FastAPI / Django routers, AltSvcMiddleware, IETF resumable uploads).
  • TLS via rustls: --tls-cert / --tls-key, SNI when repeated, --hsts, --redirect-http.
  • Static files (--static-dir), compression, shared response cache (--cache-size).
  • Access log (text or JSON), --health-check-path, --drain-delay, --max-connections, --forwarded-allow-ips, --request-id, --trace-context, --request-start-header, --rate-limit, unix sockets, --reload and SIGHUP rolling restart, --venv, --no-lifespan.
  • Prometheus on --metrics-port / --metrics-host.
  • Process workers and --worker-mode thread on free-threaded CPython 3.14t. Py_mod_gil = Py_MOD_GIL_NOT_USED.

Known

  • ACME is not implemented; leave issuance to Caddy.
  • Raw WSGI is slower than Peregrine's asyncio-free poller (76% at 256 connections on the contract). Raw ASGI and FastAPI match Peregrine and are 1.5–1.9× Granian 2.8.3. BENCHMARKS.md.

Publishing to PyPI

Wheels are built and uploaded by .github/workflows/release.yml on a v* tag. Version in Cargo.toml must match the tag (v0.1.0 → 0.1.0).

  1. On PyPI, add a pending trusted publisher for weft-server:
    • Owner: grepjava
    • Repository: weft
    • Workflow name: release.yml
    • Environment name: release
  2. git tag v0.1.0 && git push origin v0.1.0

The first upload creates the project. Later tags reuse the same publisher.