{"id":32151597,"url":"https://github.com/loopwerk/sagaswimrenderer","last_synced_at":"2026-02-21T03:02:29.035Z","repository":{"id":63916702,"uuid":"337832838","full_name":"loopwerk/SagaSwimRenderer","owner":"loopwerk","description":"A renderer for Saga that uses Swim to turn a RenderingContext into a String","archived":false,"fork":false,"pushed_at":"2025-06-23T19:46:30.000Z","size":39,"stargazers_count":4,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-20T12:30:41.854Z","etag":null,"topics":["saga-plugin"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/loopwerk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-02-10T19:35:17.000Z","updated_at":"2025-06-23T19:46:25.000Z","dependencies_parsed_at":"2023-01-14T13:45:53.458Z","dependency_job_id":null,"html_url":"https://github.com/loopwerk/SagaSwimRenderer","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/loopwerk/SagaSwimRenderer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loopwerk%2FSagaSwimRenderer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loopwerk%2FSagaSwimRenderer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loopwerk%2FSagaSwimRenderer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loopwerk%2FSagaSwimRenderer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/loopwerk","download_url":"https://codeload.github.com/loopwerk/SagaSwimRenderer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/loopwerk%2FSagaSwimRenderer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29672261,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T00:11:43.526Z","status":"online","status_checked_at":"2026-02-21T02:00:07.432Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["saga-plugin"],"created_at":"2025-10-21T10:48:04.603Z","updated_at":"2026-02-21T03:02:29.016Z","avatar_url":"https://github.com/loopwerk.png","language":"Swift","readme":"# SagaSwimRenderer\nA renderer for [Saga](https://github.com/loopwerk/Saga) that uses [Swim](https://github.com/robb/Swim) to turn a RenderingContext into a String.\n\nIt comes with a free function named `swim` which takes a function that goes from `RenderingContext` to `Node`, and turns it into a function that goes from `RenderingContext` to `String`, which can then be plugged into Saga's writers — which take functions of signature `(RenderingContext) -\u003e String`.\n\n## Example\nThe best example is Saga's [Example project](https://github.com/loopwerk/Saga/tree/main/Example/Sources/Example), although a simplified example app is [included in this repo](https://github.com/loopwerk/SagaSwimRenderer/tree/main/Example).\n\nTLDR;\n\nPackage.swift\n\n``` swift\n// swift-tools-version:5.5\n\nimport PackageDescription\n\nlet package = Package(\n  name: \"Example\",\n  platforms: [\n    .macOS(.v12)\n  ],\n  dependencies: [\n    .package(url: \"https://github.com/loopwerk/Saga\", from: \"1.0.0\"),\n    .package(url: \"https://github.com/loopwerk/SagaParsleyMarkdownReader\", from: \"0.5.0\"),\n    .package(url: \"https://github.com/loopwerk/SagaSwimRenderer\", from: \"0.6.0\")\n  ],\n  targets: [\n    .target(\n      name: \"Example\",\n      dependencies: [\n        \"Saga\",\n        \"SagaParsleyMarkdownReader\",\n        \"SagaSwimRenderer\"\n      ]\n    ),\n  ]\n)\n```\n\nmain.swift:\n\n``` swift\nimport Saga\nimport SagaParsleyMarkdownReader\nimport SagaSwimRenderer\n\n@main\nstruct Run {\n  static func main() async throws {\n    try await Saga(input: \"content\", output: \"deploy\")\n      .register(\n        metadata: EmptyMetadata.self,\n        readers: [.parsleyMarkdownReader()],\n        itemWriteMode: .keepAsFile,\n        writers: [\n          .itemWriter(swim(renderItem))\n        ]\n      )\n\n      // Run the steps we registered above\n      .run()\n\n      // All the remaining files that were not parsed to markdown, so for example images, raw html files and css,\n      // are copied as-is to the output folder.\n      .staticFiles()\n  }\n}\n\n```\n\nAnd your `renderItem` template:\n\n``` swift\nfunc renderItem(context: ItemRenderingContext\u003cEmptyMetadata, SiteMetadata\u003e) -\u003e Node {\n  html(lang: \"en-US\") {\n    body {\n      div(id: \"item\") {\n        h1 { context.item.title }\n        context.item.body\n      }\n    }\n  }\n}\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floopwerk%2Fsagaswimrenderer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Floopwerk%2Fsagaswimrenderer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Floopwerk%2Fsagaswimrenderer/lists"}