r
/
Literate.jl
mirror of https://github.com/fredrikekre/Literate.jl
1
0
Fork 0
Code Releases Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
35 Commits
4 Branches
62 Tags
20 MiB
 
Tree: 0525bf0d04
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '0525bf0d04'
${ noResults }
Literate.jl/test/runtests.jl

362 lines
11 KiB
Raw Blame History

import Examples
import Examples: Chunk, MDChunk, CodeChunk
using Compat.Test
# compare content of two parsed chunk vectors
function compare_chunks(chunks1, chunks2)
@test length(chunks1) == length(chunks2)
for (c1, c2) in zip(chunks1, chunks2)
# compare types
@test typeof(c1) == typeof(c2)
# test that no chunk start or end with ""
@test !isempty(first(c1.lines)); @test !isempty(last(c1.lines))
@test !isempty(first(c2.lines)); @test !isempty(last(c2.lines))
# compare content
for (l1, l2) in zip(c1.lines, c2.lines)
@test l1 == l2
end
# test continued code
if isa(c1, CodeChunk)
@test c1.continued == c2.continued
end
end
end
@testset "Examples.parse" begin
content = """
#' Line 1
Line 2
#' Line 3
#'
#' Line 5
Line 6
Line 8
#' Line 9
#-
#' Line 11
Line 12
#-
Line 14
#' Line 15
#-----------------
#' Line 17
Line 18
#-----------------
Line 20
#' Line 21
Line 22
Line 23
Line 24
#-
Line 26
Line 27
#-
Line 29
#-
Line 31
Line 32
#' Line 33
Line 34
#-
Line 36
#-
Line 38
#-
Line 40
#-
Line 42
Line 43
#' Line 44
Line 45
#' Line 46
Line 47
#' Line 48
#Line 49
Line 50
#'
#'
#' Line 53
#'
#'
"""
expected_chunks = Chunk[
MDChunk(["Line 1"]),
CodeChunk(["Line 2"], false),
MDChunk(["Line 3", "","Line 5"]),
CodeChunk(["Line 6", "","Line 8"], false),
MDChunk(["Line 9"]),
MDChunk(["Line 11"]),
CodeChunk(["Line 12"], false),
CodeChunk(["Line 14"], false),
MDChunk(["Line 15"]),
MDChunk(["Line 17"]),
CodeChunk(["Line 18"], false),
CodeChunk(["Line 20"], false),
MDChunk(["Line 21"]),
CodeChunk(["Line 22", " Line 23", "Line 24"], false),
CodeChunk(["Line 26", " Line 27"], true),
CodeChunk(["Line 29"], false),
CodeChunk(["Line 31", " Line 32"], true),
MDChunk(["Line 33"]),
CodeChunk(["Line 34"], false),
CodeChunk(["Line 36"], true),
CodeChunk([" Line 38"], true),
CodeChunk(["Line 40"], false),
CodeChunk(["Line 42", " Line 43"], true),
MDChunk(["Line 44"]),
CodeChunk([" Line 45"], true),
MDChunk(["Line 46"]),
CodeChunk(["Line 47"], false),
MDChunk(["Line 48"]),
CodeChunk(["#Line 49", "Line 50"], false),
MDChunk(["Line 53"]),
]
parsed_chunks = Examples.parse(content)
compare_chunks(parsed_chunks, expected_chunks)
# test leading/trailing whitespace removal
io = IOBuffer()
iows = IOBuffer()
for c in expected_chunks
if isa(c, CodeChunk)
foreach(x-> println(io, x), c.lines)
foreach(x-> println(iows, x, " "), c.lines)
else
foreach(x -> println(io, "#' ", x), c.lines)
foreach(x -> println(iows, "#' ", x, " "), c.lines)
end
println(io, "#-")
println(iows, "#-")
foreach(x -> println(iows), 1:rand(2:5))
end
compare_chunks(Examples.parse(String(take!(io))), Examples.parse(String(take!(iows))))
end # testset parser
content = """
#' # Example
x = 1
#md #' Only markdown
#md x + 1
#nb #' Only notebook
#nb x + 2
#jl #' Only script
#jl x + 3
#' Only script too #jl
x + 4 #jl
# #' Comment
# another comment
#-
for i in 1:10
print(i)
#' some markdown in a code block
end
#' Link to repo root: @__REPO_ROOT_URL__
# Link to repo root: @__REPO_ROOT_URL__
#' Link to nbviewer: @__NBVIEWER_ROOT_URL__
# Link to nbviewer: @__NBVIEWER_ROOT_URL__
#' PLACEHOLDER1
#' PLACEHOLDER2
# PLACEHOLDER3
# PLACEHOLDER4
#' Some math:
#' ```math
#' \\int f(x) dx
#' ```
"""
@testset "Examples.script" begin
mktempdir(@__DIR__) do sandbox
cd(sandbox) do
# write content to inputfile
inputfile = "inputfile.jl"
write(inputfile, content)
outdir = mktempdir(pwd())
# test defaults
withenv("TRAVIS_REPO_SLUG" => "fredrikekre/Examples.jl",
"TRAVIS_TAG" => "v1.2.0",
"HAS_JOSH_K_SEAL_OF_APPROVAL" => "true") do
Examples.script(inputfile, outdir)
end
expected_script = """
x = 1
x + 3
x + 4
# #' Comment
# another comment
for i in 1:10
print(i)
end
# Link to repo root: https://github.com/fredrikekre/Examples.jl/blob/master/
# Link to nbviewer: https://nbviewer.jupyter.org/github/fredrikekre/Examples.jl/blob/gh-pages/v1.2.0/
# PLACEHOLDER3
# PLACEHOLDER4
"""
script = read(joinpath(outdir, "inputfile.jl"), String)
script = replace(script, "\\" => "/") # normalize \ to / on Windows
@test script == expected_script
# no tag -> latest directory
withenv("TRAVIS_REPO_SLUG" => "fredrikekre/Examples.jl",
"TRAVIS_TAG" => "",
"HAS_JOSH_K_SEAL_OF_APPROVAL" => "true") do
Examples.script(inputfile, outdir)
end
script = read(joinpath(outdir, "inputfile.jl"), String)
@test contains(script, "fredrikekre/Examples.jl/blob/gh-pages/latest/")
# pre- and post-processing
Examples.script(inputfile, outdir,
preprocess = x -> replace(x, "PLACEHOLDER3" => "3REDLOHECALP"),
postprocess = x -> replace(x, "PLACEHOLDER4" => "4REDLOHECALP"))
script = read(joinpath(outdir, "inputfile.jl"), String)
@test !contains(script, "PLACEHOLDER1")
@test !contains(script, "PLACEHOLDER2")
@test !contains(script, "PLACEHOLDER3")
@test !contains(script, "PLACEHOLDER4")
@test contains(script, "3REDLOHECALP")
@test contains(script, "4REDLOHECALP")
# name
Examples.script(inputfile, outdir, name = "foobar")
namedscript = read(joinpath(outdir, "foobar.jl"), String)
Examples.script(inputfile, outdir)
nonamescrip = read(joinpath(outdir, "inputfile.jl"), String)
@test namedscript == nonamescrip
end
end
end
@testset "Examples.markdown" begin
mktempdir(@__DIR__) do sandbox
cd(sandbox) do
# write content to inputfile
inputfile = "inputfile.jl"
write(inputfile, content)
outdir = mktempdir(pwd())
# test defaults
withenv("TRAVIS_REPO_SLUG" => "fredrikekre/Examples.jl",
"TRAVIS_TAG" => "v1.2.0",
"HAS_JOSH_K_SEAL_OF_APPROVAL" => "true") do
Examples.markdown(inputfile, outdir)
end
expected_markdown = """
```@meta
EditURL = "https://github.com/fredrikekre/Examples.jl/blob/master/test/$(basename(sandbox))/inputfile.jl"
```
# Example
```@example inputfile
x = 1
```
Only markdown
```@example inputfile
x + 1
# #' Comment
# another comment
```
```@example inputfile; continued = true
for i in 1:10
print(i)
```
some markdown in a code block
```@example inputfile
end
```
Link to repo root: https://github.com/fredrikekre/Examples.jl/blob/master/
```@example inputfile
# Link to repo root: https://github.com/fredrikekre/Examples.jl/blob/master/
```
Link to nbviewer: https://nbviewer.jupyter.org/github/fredrikekre/Examples.jl/blob/gh-pages/v1.2.0/
```@example inputfile
# Link to nbviewer: https://nbviewer.jupyter.org/github/fredrikekre/Examples.jl/blob/gh-pages/v1.2.0/
```
PLACEHOLDER1
PLACEHOLDER2
```@example inputfile
# PLACEHOLDER3
# PLACEHOLDER4
```
Some math:
```math
/int f(x) dx
```
"""
markdown = read(joinpath(outdir, "inputfile.md"), String)
markdown = replace(markdown, "\\" => "/") # normalize \ to / on Windows
@test markdown == expected_markdown
# no tag -> latest directory
withenv("TRAVIS_REPO_SLUG" => "fredrikekre/Examples.jl",
"TRAVIS_TAG" => "",
"HAS_JOSH_K_SEAL_OF_APPROVAL" => "true") do
Examples.markdown(inputfile, outdir)
end
markdown = read(joinpath(outdir, "inputfile.md"), String)
@test contains(markdown, "fredrikekre/Examples.jl/blob/gh-pages/latest/")
# pre- and post-processing
Examples.markdown(inputfile, outdir,
preprocess = x -> replace(replace(x, "PLACEHOLDER1" => "1REDLOHECALP"), "PLACEHOLDER3" => "3REDLOHECALP"),
postprocess = x -> replace(replace(x, "PLACEHOLDER2" => "2REDLOHECALP"), "PLACEHOLDER4" => "4REDLOHECALP"))
markdown = read(joinpath(outdir, "inputfile.md"), String)
@test !contains(markdown, "PLACEHOLDER1")
@test !contains(markdown, "PLACEHOLDER2")
@test !contains(markdown, "PLACEHOLDER3")
@test !contains(markdown, "PLACEHOLDER4")
@test contains(markdown, "1REDLOHECALP")
@test contains(markdown, "2REDLOHECALP")
@test contains(markdown, "3REDLOHECALP")
@test contains(markdown, "4REDLOHECALP")
# documenter = false
Examples.markdown(inputfile, outdir, documenter = false)
markdown = read(joinpath(outdir, "inputfile.md"), String)
@test contains(markdown, "```julia")
@test !contains(markdown, "```@example")
@test !contains(markdown, "continued = true")
@test !contains(markdown, "EditURL")
# codefence
Examples.markdown(inputfile, outdir, codefence = "```c" => "```")
markdown = read(joinpath(outdir, "inputfile.md"), String)
@test contains(markdown, "```c")
@test !contains(markdown, "```@example")
@test !contains(markdown, "```julia")
# name
Examples.markdown(inputfile, outdir, name = "foobar")
markdown = read(joinpath(outdir, "foobar.md"), String)
@test contains(markdown, "```@example foobar")
@test !contains(markdown, "```@example inputfile")
end
end
end