How do I save the modified HTML document after using SwiftSoup?

After you've used SwiftSoup to parse and manipulate an HTML document in a Swift project, you can convert the modified document back into a string and save it to a file. Here's how you can do it:

1. Modify the HTML: Use SwiftSoup to parse the HTML, make your changes, and then convert the modified document back into an HTML string.
2. Write to a File: Use Swift's file management capabilities to save the string to a file.

Here's a step-by-step example:

import SwiftSoup

func modifyAndSaveHTML(from htmlFilePath: String, to outputFilePath: String) {
    do {
        // Read the HTML from a file
        let html = try String(contentsOfFile: htmlFilePath, encoding: .utf8)

        // Parse the HTML document with SwiftSoup
        let document = try SwiftSoup.parse(html)

        // Make modifications to the document using SwiftSoup
        // Example: changing the title
        try document.title("New Title")

        // Convert the document back to an HTML string
        let modifiedHtml = try document.outerHtml()

        // Write the modified HTML to a new file
        try modifiedHtml.write(toFile: outputFilePath, atomically: true, encoding: .utf8)

        print("HTML has been saved to \(outputFilePath)")
    } catch {
        print("An error occurred: \(error)")
    }
}

// Usage
let inputPath = "/path/to/original/document.html"
let outputPath = "/path/to/modified/document.html"
modifyAndSaveHTML(from: inputPath, to: outputPath)

In this example, the modifyAndSaveHTML function takes two parameters: the path to the original HTML file and the path where the modified HTML should be saved. It reads the original HTML file, parses it with SwiftSoup, makes a modification (in this case, changing the title of the document), converts the modified document back to an HTML string, and then writes that string to a new file.

Make sure to handle errors appropriately in a production environment, as the example above simply prints the error to the console. Also, ensure that you have permissions to read from the input file path and write to the output file path.

Remember, the example provided is very basic. SwiftSoup is a powerful library that can perform complex manipulations on an HTML document, and you would typically include more sophisticated changes to the document based on your specific requirements.