Sunny version check in generated scripts (#335)

Author: kbarros

docs/make.jl

@@ -29,7 +29,7 @@ function build_examples(example_sources, destdir)
     for source in example_sources
         # Extract "example" from "path/example.jl"
         name = splitext(basename(source))[1]
-        
+
         # Preprocess each example by adding a notebook download link at the top. The
         # relative path is hardcoded according to the layout of `gh-pages` branch,
         # which is set up by `Documenter.deploydocs`.
@@ -47,20 +47,25 @@ function build_examples(example_sources, destdir)
     # Create Jupyter notebooks and Julia script for each Literate example. These
     # will be stored in the `assets/` directory of the hosted docs.
     for source in example_sources
-        function preprocess(str)
+        function pp_vcheck(str)
+            check = "@assert pkgversion(Sunny) >= " * repr(pkgversion(Sunny))
+            return replace(str, r"^(using.*Sunny.*)$"m => SubstitutionString("\\1\n"*check))
+        end
+        function pp_wglmakie(str)
             # Ideally, notebooks would use WGLMakie instead of GLMakie, but
             # there are currently too many bugs to enable by default:
             # https://github.com/SunnySuite/Sunny.jl/issues/211
             #=
-            str = replace(str, r"^using(.*?)GLMakie"m => s"using\1WGLMakie")
+            return replace(str, r"^using(.*?)GLMakie"m => s"using\1WGLMakie")
             =#
-            str
+            return str
         end
+
         # Build notebooks
-        Literate.notebook(source, notebooks_path; preprocess, execute=false, credit=false)
+        Literate.notebook(source, notebooks_path; preprocess=pp_wglmakie∘pp_vcheck, execute=false, credit=false)
 
         # Build julia scripts
-        Literate.script(source, scripts_path; credit=false)
+        Literate.script(source, scripts_path; preprocess=pp_vcheck, credit=false)
     end
 
     # Return paths `$destpath/$name.md` for each new Markdown file (relative to