lively 0.17.0 → 0.17.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d41e94774f23353b426f53e23eb343783826c244d9bbad793759e5eea9fcd534
-  data.tar.gz: c2c5b21df4f25117d12e8c8af2e8c17113489346087cdd80a2d5b6b0dbd920d9
+  metadata.gz: c0dda7cfa299aaa995ebe540f947ab24a4f2d0f3e8dab116e064f0af1d545075
+  data.tar.gz: 1ea180ab2040f3b5b7ae191fa4f731376e366b7cf658de422d2289d929078de6
 SHA512:
-  metadata.gz: 0445eecaf41965ab7aea620f3d2886da5b2e76a5850678fcb30b60e0410aafe6d5f7d4180348564f43833b07476f2bacac00dc447a38229528ff8884ad67374e
-  data.tar.gz: f75a5afa75d4d98ad71c4a014c00ffec9b62368d1995eafe67265c05ee72e0cfd43afcc9a43374dda74b2261753348c0b34adfe672bc9d09f3566899f661e69f
+  metadata.gz: d2bc8606510afc7f5dd935bd46f3c2bb7613b9ba8a3301cb290f27b50aa5c14b65c670e09bf5a109fd41e0688542169997a7200295c64bfa9378ecf2bd685c9d
+  data.tar.gz: 327e99802f36ec9f354e5ad4195850e0e0ee7bfae7a9372b38f4442841500e7e94d80a13869096797e093da5ba8f5d37f04811dd801e854fb3f10e83127d9866

data/context/getting-started.md

@@ -62,6 +62,80 @@ $ ./application.rb
 
 You should see "Hello World!" displayed in your browser.
 
+## Shared State
+
+When multiple browser windows need to share state — for example, a multiplayer game or a collaborative tool — you can pass shared state to `Application[]`. The state is passed as keyword arguments to all views, both during the initial page render and when browsers reconnect via WebSocket.
+
+```ruby
+#!/usr/bin/env lively
+
+class GameState
+	def initialize
+		@players = []
+	end
+	
+	attr :players
+	
+	def add_player(player)
+		@players << player
+	end
+end
+
+class GameView < Live::View
+	def initialize(id = self.class.unique_id, data = {}, game_state: nil)
+		super(id, data)
+		@game_state = game_state
+	end
+	
+	def render(builder)
+		builder.tag(:p) do
+			builder.text("Players: #{@game_state.players.length}")
+		end
+	end
+end
+
+Application = Lively::Application[GameView, game_state: GameState.new]
+```
+
+The `game_state:` keyword is passed to every `GameView` instance — whether created by the initial page load or by a WebSocket reconnection. This means all connected browsers share the same `GameState` object.
+
+For more complex applications, subclass {ruby Lively::Application} and override `#state`, `#allowed_views`, and `#body`:
+
+```ruby
+class Application < Lively::Application
+	def allowed_views
+		[DisplayView, ControlView]
+	end
+	
+	def state
+		{controller: @controller}
+	end
+	
+	def initialize(delegate)
+		@controller = MyController.new
+		super
+	end
+	
+	def body(request)
+		case request.path
+		when "/"
+			DisplayView.new(**state)
+		when "/control"
+			ControlView.new(**state)
+		end
+	end
+	
+	def handle(request)
+		if body = self.body(request)
+			page = Lively::Pages::Index.new(title: "My App", body: body)
+			Protocol::HTTP::Response[200, [], [page.call]]
+		else
+			Protocol::HTTP::Response[404, [], ["Not Found"]]
+		end
+	end
+end
+```
+
 ## Live Reloading
 
 To enable live reloading, add the `io-watch` gem to your `gems.rb` file:

data/lib/lively/version.rb

@@ -5,5 +5,5 @@
 
 # @namespace
 module Lively
-	VERSION = "0.17.0"
+	VERSION = "0.17.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lively
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.17.1
 platform: ruby
 authors:
 - Samuel Williams