feat(inner content): allow passing content as a function, as a custom parser

[DavidVujic]

Description

To allow passing in inner html as a string, without escaping the content.

Example: adding © as inner html, it is now possible to pass the content as a function (or a custom render function for that particular content).

from python_hiccup.html import raw

data = ["div", raw("&copy; this should <strong>not</strong> be escaped!")]

the rendered output:

<div>&copy; this should <strong>not</strong> be escaped!</div>

Motivation and Context

Idea and feature request coming from #12 ⭐

This Pull Request is an alternative to the proposed solution.

How Has This Been Tested?

✅ CI
✅ Added unit test

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)

Checklist:

• I have read the code of conduct.
• I have read the contributing guide.
• I have updated the documentation accordingly (if applicable).

[lukal-x]

Much nicer than my approach.

My 2 cents is: hiccup signifies with the function name raw https://weavejester.github.io/hiccup/hiccup2.core.html#var-raw that the string will be injected as-is which is potentially dangerous, reminding the programmer using it to consider the risks.

[DavidVujic]

Much nicer than my approach.

My 2 cents is: hiccup signifies with the function name raw https://weavejester.github.io/hiccup/hiccup2.core.html#var-raw that the string will be injected as-is which is potentially dangerous, reminding the programmer using it to consider the risks.

Good idea! I have added a helper function that can be used for this purpose.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud