2add8847a1
* Enable swift 6 mode * Attach Sendable * Stop async context because enumerator can use only synchronous contexts * Fix global shared mutable state for MustacheContentTypes * Revert "Fix global shared mutable state for MustacheContentTypes" This reverts commit d4ccc83e07aeb48f4aa4024b71eb8e5f70131bc5. * Use instead of lock * Support 5 and 6 versions * Lock on access in Swift 6 * Support 5.9 * Revert "Support 5.9" This reverts commit 9845b3bc448b2af7238c3ac88aabe6d764b2e667. * Fix 5.9 compatibility * Unify to manage the same lock logic in 5.9 and 6 * Add withLock backport in NSLock
106 lines
3.9 KiB
Swift
106 lines
3.9 KiB
Swift
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This source file is part of the Hummingbird server framework project
|
|
//
|
|
// Copyright (c) 2021-2024 the Hummingbird authors
|
|
// Licensed under Apache License v2.0
|
|
//
|
|
// See LICENSE.txt for license information
|
|
// See hummingbird/CONTRIBUTORS.txt for the list of Hummingbird authors
|
|
//
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
/// Class holding a collection of mustache templates.
|
|
///
|
|
/// Each template can reference the others via a partial using the name the template is registered under
|
|
/// ```
|
|
/// {{#sequence}}{{>entry}}{{/sequence}}
|
|
/// ```
|
|
public struct MustacheLibrary: Sendable {
|
|
/// Initialize empty library
|
|
public init() {
|
|
self.templates = [:]
|
|
}
|
|
|
|
/// Initialize library with collection of templates.
|
|
///
|
|
/// Each template is mapped to a name which can then be used as the partial name.
|
|
/// - Parameter templates: Dictionary of mustache templates with a String key
|
|
public init(templates: [String: MustacheTemplate]) {
|
|
self.templates = templates
|
|
}
|
|
|
|
/// Initialize library with contents of folder.
|
|
///
|
|
/// Each template is registered with the name of the file minus its extension. The search through
|
|
/// the folder is recursive and templates in subfolders will be registered with the name `subfolder/template`.
|
|
/// - Parameter directory: Directory to look for mustache templates
|
|
/// - Parameter extension: Extension of files to look for
|
|
public init(directory: String, withExtension extension: String = "mustache") async throws {
|
|
self.templates = try Self.loadTemplates(from: directory, withExtension: `extension`)
|
|
}
|
|
|
|
/// Register template under name
|
|
/// - Parameters:
|
|
/// - template: Template
|
|
/// - name: Name of template
|
|
public mutating func register(_ template: MustacheTemplate, named name: String) {
|
|
self.templates[name] = template
|
|
}
|
|
|
|
/// Register template under name
|
|
/// - Parameters:
|
|
/// - mustache: Mustache text
|
|
/// - name: Name of template
|
|
public mutating func register(_ mustache: String, named name: String) throws {
|
|
let template = try MustacheTemplate(string: mustache)
|
|
self.templates[name] = template
|
|
}
|
|
|
|
/// Return template registed with name
|
|
/// - Parameter name: name to search for
|
|
/// - Returns: Template
|
|
public func getTemplate(named name: String) -> MustacheTemplate? {
|
|
self.templates[name]
|
|
}
|
|
|
|
/// Render object using templated with name
|
|
/// - Parameters:
|
|
/// - object: Object to render
|
|
/// - name: Name of template
|
|
/// - Returns: Rendered text
|
|
public func render(_ object: Any, withTemplate name: String) -> String? {
|
|
guard let template = templates[name] else { return nil }
|
|
return template.render(object, library: self)
|
|
}
|
|
|
|
/// Render object using templated with name
|
|
/// - Parameters:
|
|
/// - object: Object to render
|
|
/// - name: Name of template
|
|
/// - reload: Reload templates when rendering. This is only available in debug builds
|
|
/// - Returns: Rendered text
|
|
public func render(_ object: Any, withTemplate name: String, reload: Bool) -> String? {
|
|
guard let template = templates[name] else { return nil }
|
|
#if DEBUG
|
|
return template.render(object, library: self, reload: reload)
|
|
#else
|
|
return template.render(object, library: self)
|
|
#endif
|
|
}
|
|
|
|
/// Error returned by init() when parser fails
|
|
public struct ParserError: Swift.Error {
|
|
/// File error occurred in
|
|
public let filename: String
|
|
/// Context (line, linenumber and column number)
|
|
public let context: MustacheParserContext
|
|
/// Actual error that occurred
|
|
public let error: Error
|
|
}
|
|
|
|
private var templates: [String: MustacheTemplate]
|
|
}
|