Standard test suite for packages under JuliaFEM organization. The purpose of this package is to
- avoid unnecessary boilerplate code of setting up new packages, and
- provide a standardized way to test that package matches to JuliaFEM standards.
Usage from command line:
julia> using PkgTestSuite
julia> test(pkg_name)
julia> deploy(pkg_name)If running deploy() from command line, documentation is generated to docs/site.
Usage from Travis-CI:
before_script:
- julia --color=yes -e 'Pkg.clone("https://github.com/JuliaFEM/PkgTestSuite.jl.git")'
- julia --color=yes -e 'using PkgTestSuite; init()'
script:
- julia --color=yes -e 'using PkgTestSuite; test()'
after_success:
- julia --color=yes -e 'using PkgTestSuite; deploy()'Default sequence is:
- check that all source files contain licence string
- check that no tabs are used in source files
- check code syntax using Lint.jl
- generate documentation of package using Documenter.jl
- run all unit tests
- deploy documentation to juliafem.github.io and coverage report to coveralls.io
By default build will fail if any item in above is failing. Something this
might be too strict requirement, especially for older packages. For that
reason is's possible to set key LINT_STRICT to false in Travis environment
variable to make deploy success even if Lint.jl is giving some warnings.
Correspondingly there is a key DOCUMENTER_STRICT which can be set to false
to skip errors in Documenter.jl caused by missing docstrings or failed doctests.