spooder 4.5.6 → 4.5.8

package/README.md

@@ -35,7 +35,7 @@ The `CLI` component of `spooder` is a global command-line tool for running serve
 `spooder` exposes a simple yet powerful API for developing servers. The API is designed to be minimal to leave control in the hands of the developer and not add overhead for features you may not need.
 
 - [API > Serving](#api-serving)
-	- [`serve(port: number): Server`](#api-serving-serve)
+	- [`serve(port: number, hostname?: string): Server`](#api-serving-serve)
 - [API > Routing](#api-routing)
 	- [`server.route(path: string, handler: RequestHandler, method: HTTP_METHODS)`](#api-routing-server-route)
 	- [`server.unroute(path: string)`](#api-routing-server-unroute)
@@ -468,14 +468,15 @@ In addition to the information provided by the developer, `spooder` also include
 ## API > Serving
 
 <a id="api-serving-serve"></a>
-### `serve(port: number): Server`
+### `serve(port: number, hostname?: string): Server`
 
-Bootstrap a server on the specified port.
+Bootstrap a server on the specified port (and optional hostname).
 
 ```ts
 import { serve } from 'spooder';
 
-const server = serve(8080);
+const server = serve(8080); // port only
+const server = serve(3000, '0.0.0.0'); // optional hostname
 ```
 
 By default, the server responds with:
@@ -1214,6 +1215,16 @@ await parse_template('Hello {$world}', replacer);
 </html>
 ```
 
+`parse_template` supports optional scopes with the following syntax.
+
+```html
+{$if:foo}I love {$foo}{/if}
+```
+Contents contained inside an `if` block will be rendered providing the given value, in this case `foo` is truthy in the substitution table.
+
+An `if` block is only removed if `drop_missing` is `true`, allowing them to persist through multiple passes of a template.
+
+
 `parse_template` supports looping arrays with the following syntax.
 
 ```html

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "spooder",
 	"type": "module",
-	"version": "4.5.6",
+	"version": "4.5.8",
 	"exports": {
 		".": {
 			"bun": "./src/api.ts",

package/src/api.ts

@@ -173,6 +173,25 @@ export async function parse_template(template: string, replacements: Replacement
 					}
 					i += loop_content.length + 6;
 				}
+			} else if (buffer.startsWith('if:')) {
+				const if_key = buffer.substring(3);
+				const if_content_start_index = i + 1;
+				const if_close_index = template.indexOf('{/if}', if_content_start_index);
+
+				if (if_close_index === -1) {
+					if (!drop_missing)
+						result += '{$' + buffer + '}';
+				} else {
+					const if_content = template.substring(if_content_start_index, if_close_index);
+					const condition_value = is_replacer_fn ? await replacements(if_key) : replacements[if_key];
+
+					if (!drop_missing) {
+						result += '{$' + buffer + '}' + if_content + '{/if}';
+					} else if (condition_value) {
+						result += await parse_template(if_content, replacements, drop_missing);
+					}
+					i += if_content.length + 5;
+				}
 			} else {
 				const replacement = is_replacer_fn ? await replacements(buffer) : replacements[buffer];
 				if (replacement !== undefined)
@@ -616,7 +635,7 @@ function is_valid_method(method: HTTP_METHODS, req: Request): boolean {
 	return req.method === method;
 }
 
-export function serve(port: number) {
+export function serve(port: number, hostname?: string) {
 	const routes = new Array<[string[], RequestHandler, HTTP_METHODS]>();
 	const handlers = new Map<number, StatusCodeHandler>();
 	
@@ -744,6 +763,7 @@ export function serve(port: number) {
 
 	const server = Bun.serve({
 		port,
+		hostname,
 		development: false,
 
 		async fetch(req: Request): Promise<Response> {
@@ -796,7 +816,7 @@ export function serve(port: number) {
 		}
 	});
 
-	log('server started on port {%d}', port);
+	log('server started on port {%d} (host: {%s})', port, hostname ?? 'unspecified');
 
 	return {
 		/** Register a handler for a specific route. */