Expression.V2.Autodoc (expression v2.47.3)
Extract @expression_doc attributes from modules defining callbacks
and automatically write doctests for those.
Also inserts an expression_docs() function which returns a list of
all functions and their defined expression docs.
The format is:
@expression_doc doc: "Construct a date from year, month, and day integers",
expression: "@date(year, month, day)",
context: %{"year" => 2022, "month" => 1, "day" => 31},
result: "2022-01-31T00:00:00Z"Where:
docis the explanatory text added to the doctest.expressionis the expression we want to testfake_expressioncan optionally be the expression we want to display but not testcontextis the context the expression is tested againstresultis the result we're expecting to get and are asserting againstfake_resultcan be optionally supplied when the returning result varies depending on factors we do not control, like fornow()for example. When this is used, the ExDoc tests are faked and won't actually test anything so use sparingly.