# A dummy GenericPlugin subtype. struct Foo <: GenericPlugin gitignore::Vector{AbstractString} src::Union{AbstractString, Nothing} dest::AbstractString badges::Vector{Badge} view::Dict{String, Any} function Foo(; config_file=test_file) new([], @__FILE__, config_file, [Badge("foo", "bar", "baz")], Dict{String, Any}()) end end # A dummy CustomPlugin subtype. struct Bar <: CustomPlugin end # A dummy Plugin subtype. struct Baz <: Plugin end # Various options to be passed into templates. const me = "christopher-dG" const gitconfig = Dict( "user.name" => "Tester McTestFace", "user.email" => "email@web.site", "github.user" => "TesterMcTestFace", ) const test_pkg = "TestPkg" const fake_path = string(hash("/this/file/does/not/exist"); base=2) const test_file = tempname() const default_dir = PkgTemplates.dev_dir() const template_text = """ PKGNAME: {{PKGNAME}} VERSION: {{VERSION}}} {{#DOCUMENTER}}Documenter{{/DOCUMENTER}} {{#CODECOV}}CodeCov{{/CODECOV}} {{#COVERALLS}}Coveralls{{/COVERALLS}} {{#AFTER}}After{{/AFTER}} {{#OTHER}}Other{{/OTHER}} """ write(test_file, template_text) @testset "Template creation" begin # Checking default field assignments. t = Template(; user=me) @test t.user == me @test t.license == "MIT" @test t.years == string(Dates.year(Dates.today())) @test t.authors == LibGit2.getconfig("user.name", "") @test t.dir == default_dir @test t.julia_version == VERSION @test isempty(t.gitconfig) @test isempty(t.plugins) # Checking non-default field assignments. t = Template(; user=me, license="") @test t.license == "" t = Template(; user=me, license="MPL") @test t.license == "MPL" t = Template(; user=me, years=2014) @test t.years == "2014" t = Template(user=me, years="2014-2015") @test t.years == "2014-2015" t = Template(; user=me, authors="Some Guy") @test t.authors == "Some Guy" # Vectors of authors should be comma-joined. t = Template(; user=me, authors=["Guy", "Gal"]) @test t.authors == "Guy, Gal" t = Template(; user=me, dir=test_file) @test t.dir == abspath(test_file) if Sys.isunix() # ~ means temporary file on Windows, not $HOME. # '~' should be replaced by home dir. t = Template(; user=me, dir="~/$(basename(test_file))") @test t.dir == joinpath(homedir(), basename(test_file)) end t = Template(; user=me, precompile=false) @test !t.precompile t = Template(; user=me, julia_version=v"0.1.2") @test t.julia_version == v"0.1.2" t = Template(; user=me, requirements=["$test_pkg 0.1"]) @test t.requirements == ["$test_pkg 0.1"] # Duplicate requirements should warn. @test_logs (:warn, r".+") t = Template(; user=me, requirements=[test_pkg, test_pkg]) @test t.requirements == [test_pkg] # Duplicate requirements with non-matching versions should throw. @test_throws ArgumentError Template(; user=me, requirements=[test_pkg, "$test_pkg 0.1"] ) t = Template(; user=me, gitconfig=gitconfig) @test t.gitconfig == gitconfig # Git options should be used as fallbacks for template user and authors. # But an explicitly passed username trumps the gitconfig. t = Template(; user=me, gitconfig=gitconfig) @test t.authors == gitconfig["user.name"] t = Template(; gitconfig=gitconfig) @test t.user == gitconfig["github.user"] @test t.authors == gitconfig["user.name"] # The template should contain whatever plugins you give it. t = Template(; user=me, plugins = [GitHubPages(), TravisCI(), AppVeyor(), CodeCov(), Coveralls()], ) @test Set(keys(t.plugins)) == Set( [GitHubPages, TravisCI, AppVeyor, CodeCov, Coveralls] ) @test Set(values(t.plugins)) == Set( [GitHubPages(), TravisCI(), AppVeyor(), CodeCov(), Coveralls()] ) # Duplicate plugins should warn. @test_logs (:warn, r".+") t = Template(; user=me, plugins=[TravisCI(), TravisCI()], ) # If github.user is configured, use that as a default. if isempty(LibGit2.getconfig("github.user", "")) @test_throws ArgumentError Template() else t = Template() @test t.user == LibGit2.getconfig("github.user", "") end @test_throws ArgumentError Template(; user=me, license="FakeLicense") end # TerminalMenus doesn't work quite right on Travis OSX. if get(ENV, "TRAVIS_OS_NAME", "") != "osx" include(joinpath("interactive", "interactive.jl")) @testset "Interactive plugin creation" begin include(joinpath("interactive", "plugins.jl")) end else @info "Skipping tests that require TerminalMenus on OSX" end @testset "Show methods" begin pkg_dir = replace(default_dir, homedir() => "~") buf = IOBuffer() t = Template(; user=me, gitconfig=gitconfig) show(buf, t) text = String(take!(buf)) expected = """ Template: → User: $me → Host: github.com → License: MIT ($(gitconfig["user.name"]) $(Dates.year(now()))) → Package directory: $pkg_dir → Precompilation enabled: Yes → Minimum Julia version: v$(PkgTemplates.version_floor()) → 0 package requirements → Git configuration options: • github.user = $(gitconfig["github.user"]) • user.email = $(gitconfig["user.email"]) • user.name = $(gitconfig["user.name"]) → Plugins: None """ @test text == rstrip(expected) t = Template( user=me, license="", requirements=["Foo", "Bar"], gitconfig=gitconfig, plugins=[ TravisCI(), CodeCov(), GitHubPages(), ], ) show(buf, t) text = String(take!(buf)) expected = """ Template: → User: $me → Host: github.com → License: None → Package directory: $pkg_dir → Precompilation enabled: Yes → Minimum Julia version: v$(PkgTemplates.version_floor()) → 2 package requirements: Bar, Foo → Git configuration options: • github.user = $(gitconfig["github.user"]) • user.email = $(gitconfig["user.email"]) • user.name = $(gitconfig["user.name"]) → Plugins: • CodeCov: → Config file: None → 3 gitignore entries: "*.jl.cov", "*.jl.*.cov", "*.jl.mem" • GitHubPages: → 0 asset files → 2 gitignore entries: "/docs/build/", "/docs/site/" • TravisCI: → Config file: Default → 0 gitignore entries """ @test text == rstrip(expected) end @testset "File generation" begin t = Template(; user=me, license="MPL", requirements=[test_pkg], gitconfig=gitconfig, plugins=[Coveralls(), TravisCI(), CodeCov(), GitHubPages(), AppVeyor()], ) temp_dir = mktempdir() pkg_dir = joinpath(temp_dir, test_pkg) temp_file = tempname() gen_file(temp_file, "Hello, world") @test isfile(temp_file) @test read(temp_file, String) == "Hello, world\n" rm(temp_file) # Test the README generation. @test gen_readme(temp_dir, test_pkg, t) == ["README.md"] @test isfile(joinpath(pkg_dir, "README.md")) readme = readchomp(joinpath(pkg_dir, "README.md")) rm(joinpath(pkg_dir, "README.md")) @test occursin("# $test_pkg", readme) for p in values(t.plugins) @test occursin(join(badges(p, t.user, test_pkg), "\n"), readme) end # Check the order of the badges. @test something(findfirst("github.io", readme)).start < something(findfirst("travis", readme)).start < something(findfirst("appveyor", readme)).start < something(findfirst("codecov", readme)).start < something(findfirst("coveralls", readme)).start # Plugins with badges but not in BADGE_ORDER should appear at the far right side. t.plugins[Foo] = Foo() gen_readme(temp_dir, test_pkg, t) readme = readchomp(joinpath(pkg_dir, "README.md")) rm(joinpath(pkg_dir, "README.md")) @test <( something(findfirst("coveralls", readme)).start, something(findfirst("baz", readme)).start, ) # Test the gitignore generation. @test gen_gitignore(temp_dir, test_pkg, t) == [".gitignore"] @test isfile(joinpath(pkg_dir, ".gitignore")) gitignore = read(joinpath(pkg_dir, ".gitignore"), String) rm(joinpath(pkg_dir, ".gitignore")) @test occursin(".DS_Store", gitignore) for p in values(t.plugins) for entry in p.gitignore @test occursin(entry, gitignore) end end # Test the license generation. @test gen_license(temp_dir, test_pkg, t) == ["LICENSE"] @test isfile(joinpath(pkg_dir, "LICENSE")) license = readchomp(joinpath(pkg_dir, "LICENSE")) rm(joinpath(pkg_dir, "LICENSE")) @test occursin(t.authors, license) @test occursin(t.years, license) @test occursin(read_license(t.license), license) # Test the source code entrypoint generation. @test gen_entrypoint(temp_dir, test_pkg, t) == ["src/"] @test isdir(joinpath(pkg_dir, "src")) @test isfile(joinpath(pkg_dir, "src", "$test_pkg.jl")) entrypoint = readchomp(joinpath(pkg_dir, "src", "$test_pkg.jl")) rm(joinpath(pkg_dir, "src"); recursive=true) @test occursin("__precompile__()", entrypoint) @test occursin("module $test_pkg", entrypoint) t2 = Template(; user=me, precompile=false) gen_entrypoint(temp_dir, test_pkg, t2) entrypoint = readchomp(joinpath(pkg_dir, "src", "$test_pkg.jl")) @test !occursin("__precompile__()", entrypoint) @test occursin("module $test_pkg", entrypoint) rm(joinpath(pkg_dir, "src"); recursive=true) # Test the REQUIRE generation. @test gen_require(temp_dir, test_pkg, t) == ["REQUIRE"] @test isfile(joinpath(pkg_dir, "REQUIRE")) vf = version_floor(t.julia_version) @test readchomp(joinpath(pkg_dir, "REQUIRE")) == "julia $vf\n$test_pkg" rm(joinpath(pkg_dir, "REQUIRE")) # Test the test generation. @test gen_tests(temp_dir, test_pkg, t) == ["test/"] @test isdir(joinpath(pkg_dir, "test")) @test isfile(joinpath(pkg_dir, "test", "runtests.jl")) runtests = readchomp(joinpath(pkg_dir, "test", "runtests.jl")) rm(joinpath(pkg_dir, "test"); recursive=true) @test occursin("using $test_pkg", runtests) @test occursin("using Base.Test", runtests) rm(temp_dir; recursive=true) end @testset "Package generation" begin t = Template(; user=me, gitconfig=gitconfig) generate(test_pkg, t) pkg_dir = joinpath(default_dir, test_pkg) # Check that the expected files all exist. @test isfile(joinpath(pkg_dir, "LICENSE")) @test isfile(joinpath(pkg_dir, "README.md")) @test isfile(joinpath(pkg_dir, "REQUIRE")) @test isfile(joinpath(pkg_dir, ".gitignore")) @test isdir(joinpath(pkg_dir, "src")) @test isfile(joinpath(pkg_dir, "src", "$test_pkg.jl")) @test isdir(joinpath(pkg_dir, "test")) @test isfile(joinpath(pkg_dir, "test", "runtests.jl")) # Check the gitconfig. repo = LibGit2.GitRepo(pkg_dir) remote = LibGit2.get(LibGit2.GitRemote, repo, "origin") branches = map(b -> LibGit2.shortname(first(b)), LibGit2.GitBranchIter(repo)) @test LibGit2.getconfig(repo, "user.name", "") == gitconfig["user.name"] # Check the configured remote and branches. # Note: This test will fail on your system if you've configured Git # to replace all HTTPS URLs with SSH. @test LibGit2.url(remote) == "https://github.com/$me/$test_pkg.jl" @test in("master", branches) @test !in("gh-pages", branches) @test !LibGit2.isdirty(repo) rm(pkg_dir; recursive=true) # Check that the remote is an SSH URL. generate(t, test_pkg; ssh=true) # Test the reversed-arguments method. repo = LibGit2.GitRepo(pkg_dir) remote = LibGit2.get(LibGit2.GitRemote, repo, "origin") @test LibGit2.url(remote) == "git@github.com:$me/$test_pkg.jl.git" rm(pkg_dir; recursive=true) # Check that the remote is set correctly for non-default hosts. t = Template(; user=me, host="gitlab.com", gitconfig=gitconfig) generate(test_pkg, t) repo = LibGit2.GitRepo(pkg_dir) remote = LibGit2.get(LibGit2.GitRemote, repo, "origin") @test LibGit2.url(remote) == "https://gitlab.com/$me/$test_pkg.jl" rm(pkg_dir; recursive=true) # Check that the package ends up in the right directory. temp_dir = mktempdir() t = Template(; user=me, dir=temp_dir, gitconfig=gitconfig) generate(test_pkg, t) @test isdir(joinpath(temp_dir, test_pkg)) rm(temp_dir; recursive=true) # Check that all the plugin files are generated. t = Template(; user=me, license="", gitconfig=gitconfig, plugins=[AppVeyor(), GitHubPages(), Coveralls(), CodeCov(), TravisCI()], ) generate(test_pkg, t) @test isdir(pkg_dir) @test !isfile(joinpath(pkg_dir, "LICENSE")) @test isfile(joinpath(pkg_dir, ".travis.yml")) @test isfile(joinpath(pkg_dir, ".appveyor.yml")) @test isdir(joinpath(pkg_dir, "docs")) @test isfile(joinpath(pkg_dir, "docs", "make.jl")) @test isdir(joinpath(pkg_dir, "docs", "src")) @test isfile(joinpath(pkg_dir, "docs", "src", "index.md")) # Test that the gh-pages exists for GitHubPages. repo = LibGit2.GitRepo(pkg_dir) @test LibGit2.getconfig(repo, "user.name", "") == gitconfig["user.name"] branches = map(b -> LibGit2.shortname(first(b)), LibGit2.GitBranchIter(repo)) @test in("gh-pages", branches) @test !LibGit2.isdirty(repo) rm(pkg_dir; recursive=true) # Check that an existing directory is removed when force is set. mkdir(pkg_dir) @test_throws ArgumentError generate(test_pkg, t) generate(test_pkg, t; force=true) @test isfile(joinpath(pkg_dir, "README.md")) rm(pkg_dir; recursive=true) # Check that the backup directory mechanism works. temp_file, io = mktemp() close(io) temp_dir = mktempdir() t = Template(; user=me, dir=temp_file) @test_logs (:warn, r".+") match_mode=:any generate(test_pkg, t; backup_dir=temp_dir) rm(temp_dir; recursive=true) temp_dir = mktempdir() t = Template(; user=me, dir=joinpath(temp_file, "dir")) @test_logs (:warn, r".+") match_mode=:any generate(test_pkg, t; backup_dir=temp_dir) rm(temp_dir; recursive=true) rm(temp_file) # Check that the generated docs root is just the copied README. t = Template(; user=me, gitconfig=gitconfig, plugins=[GitHubPages()]) generate(test_pkg, t) readme = read(joinpath(pkg_dir, "README.md"), String) index = read(joinpath(pkg_dir, "docs", "src", "index.md"), String) @test readme == index rm(pkg_dir; recursive=true) end @testset "Version floor" begin @test version_floor(v"1.0.0") == "1.0" @test version_floor(v"1.0.1") == "1.0" @test version_floor(v"1.0.1-pre") == "1.0" @test version_floor(v"1.0.0-pre") == "1.0-" end @testset "Mustache substitution" begin view = Dict{String, Any}() text = substitute(template_text, view) @test !occursin("PKGNAME: $test_pkg", text) @test !occursin("Documenter", text) @test !occursin("CodeCov", text) @test !occursin("Coveralls", text) @test !occursin("After", text) @test !occursin("Other", text) view["PKGNAME"] = test_pkg view["OTHER"] = true text = substitute(template_text, view) @test occursin("PKGNAME: $test_pkg", text) @test occursin("Other", text) t = Template(; user=me) view["OTHER"] = false text = substitute(template_text, t; view=view) @test occursin("PKGNAME: $test_pkg", text) @test occursin("VERSION: $(t.julia_version.major).$(t.julia_version.minor)", text) @test !occursin("Documenter", text) @test !occursin("After", text) @test !occursin("Other", text) t.plugins[GitHubPages] = GitHubPages() text = substitute(template_text, t; view=view) @test occursin("Documenter", text) @test occursin("After", text) empty!(t.plugins) t.plugins[CodeCov] = CodeCov() text = substitute(template_text, t; view=view) @test occursin("CodeCov", text) @test occursin("After", text) empty!(t.plugins) t.plugins[Coveralls] = Coveralls() text = substitute(template_text, t; view=view) @test occursin("Coveralls", text) @test occursin("After", text) empty!(t.plugins) view["OTHER"] = true text = substitute(template_text, t; view=view) @test occursin("Other", text) end @testset "License display" begin io = IOBuffer() available_licenses(io) licenses = String(take!(io)) show_license(io, "MIT") mit = String(take!(io)) # Check that all licenses are included in the display. for (short, long) in LICENSES @test occursin("$short: $long", licenses) end @test strip(mit) == strip(read_license("MIT")) @test strip(read_license("MIT")) == strip(read(joinpath(LICENSE_DIR, "MIT"), String)) @test_throws ArgumentError read_license(fake_path) # Check that all licenses included with the package are displayed. for license in readdir(LICENSE_DIR) @test haskey(LICENSES, license) end # Check that all licenses displayed are included with the package. @test length(readdir(LICENSE_DIR)) == length(LICENSES) end @testset "Plugins" begin user = gitconfig["github.user"] t = Template(; user=me) temp_dir = mktempdir() pkg_dir = joinpath(temp_dir, test_pkg) # Check badge constructor and formatting. badge = Badge("A", "B", "C") @test badge.hover == "A" @test badge.image == "B" @test badge.link == "C" @test format(badge) == "[![A](B)](C)" p = Bar() @test isempty(badges(p, user, test_pkg)) @test isempty(gen_plugin(p, t, temp_dir, test_pkg)) p = Baz() @test isempty(badges(p, user, test_pkg)) @test isempty(gen_plugin(p, t, temp_dir, test_pkg)) include(joinpath("plugins", "travisci.jl")) include(joinpath("plugins", "appveyor.jl")) include(joinpath("plugins", "gitlabci.jl")) include(joinpath("plugins", "codecov.jl")) include(joinpath("plugins", "coveralls.jl")) include(joinpath("plugins", "githubpages.jl")) rm(temp_dir; recursive=true) end rm(test_file)