Merge pull request #285 from ranocha/hr/test_project

Author: haampie

.github/workflows/CompatHelper.yml

@@ -1,19 +1,19 @@
 name: CompatHelper
-
 on:
   schedule:
     - cron: '00 00 * * *'
-
+  workflow_dispatch:
 jobs:
   CompatHelper:
     runs-on: ubuntu-latest
     steps:
       - uses: julia-actions/setup-julia@latest
         with:
-          version: 1.3
+          version: 1.5
       - name: Pkg.add("CompatHelper")
         run: julia -e 'using Pkg; Pkg.add("CompatHelper")'
       - name: CompatHelper.main()
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: julia -e 'using CompatHelper; CompatHelper.main()'
+          COMPATHELPER_PRIV: ${{ secrets.DOCUMENTER_KEY }}  # optional
+        run: julia -e 'using CompatHelper; CompatHelper.main(; subdirs=["", "docs", "test"])'

Project.toml

@@ -1,6 +1,6 @@
 name = "IterativeSolvers"
 uuid = "42fd0dbc-a981-5370-80f2-aaf504508153"
-version = "0.8.4"
+version = "0.8.5"
 
 [deps]
 LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
@@ -12,10 +12,3 @@ SparseArrays = "2f01184e-e22b-5df5-ae63-d93ebab69eaf"
 [compat]
 RecipesBase = "0.6, 0.7, 0.8, 1.0"
 julia = "1"
-
-[extras]
-LinearMaps = "7a12625a-238d-50fd-b39a-03d52299707e"
-Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
-
-[targets]
-test = ["Test", "LinearMaps"]

README.md

@@ -14,7 +14,7 @@
 
 ## Installing
 
-To install the package, open the package manager in the REPL via ] and run
+To install the package, open the package manager in the REPL via `]` and run
 
 ```julia
 pkg> add IterativeSolvers

docs/src/iterators.md

@@ -28,45 +28,48 @@ jacobi_iterable(x, A::SparseMatrixCSC, b; maxiter::Int = 10) =
 
 Now if you apply Jacobi iteration multiple times with the same matrix for just a few iterations, it makes sense to initialize the iterable only once and reuse it afterwards:
 
-```julia
-A = sprand(10_000, 10_000, 10 / 10_000) + 20I
-b1 = rand(10_000)
-b2 = rand(10_000)
-x = rand(10_000)
-
-my_iterable = IterativeSolvers.jacobi_iterable(x, A, b1, maxiter = 4)
+```jldoctest
+julia> using LinearAlgebra, SparseArrays, IterativeSolvers
 
-for item in my_iterable
-    println("Iteration for rhs 1")
-end
+julia> A = spdiagm(-1 => -ones(3), 0 => 2*ones(4), 1 => -ones(3));
 
-@show norm(b1 - A * x) / norm(b1)
+julia> b1 = [1.0, 2, 3, 4];
 
-# Copy the next right-hand side into the iterable
-copyto!(my_iterable.b, b2)
+julia> b2 = [-1.0, 1, -1, 1];
 
-for item in my_iterable
-    println("Iteration for rhs 2")
-end
+julia> x = [0.0, -1, 1, 0];
 
-@show norm(b2 - A * x) / norm(b2)
-```
+julia> my_iterable = IterativeSolvers.jacobi_iterable(x, A, b1, maxiter = 2);
 
-This would output:
+julia> norm(b1 - A * x) / norm(b1)
+1.2909944487358056
 
-```
-Iteration for rhs 1
-Iteration for rhs 1
+julia> for item in my_iterable
+           println("Iteration for rhs 1")
+       end
 Iteration for rhs 1
 Iteration for rhs 1
-norm(b1 - A * x) / norm(b1) = 0.08388528015119746
-Iteration for rhs 2
-Iteration for rhs 2
+
+julia> norm(b1 - A * x) / norm(b1)
+0.8228507357554791
+
+julia> # Copy the next right-hand side into the iterable
+       copyto!(my_iterable.b, b2);
+
+julia> norm(b2 - A * x) / norm(b2)
+2.6368778887161235
+
+julia> for item in my_iterable
+           println("Iteration for rhs 2")
+       end
 Iteration for rhs 2
 Iteration for rhs 2
-norm(b2 - A * x) / norm(b2) = 0.0003681972775644809
+
+julia> norm(b2 - A * x) / norm(b2)
+1.610815496107484
 ```
 
+
 ## Other use cases
 Other use cases include:
 - computing the (harmonic) Ritz values from the Hessenberg matrix in GMRES;

test/Project.toml

@@ -0,0 +1,13 @@
+[deps]
+Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
+LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
+LinearMaps = "7a12625a-238d-50fd-b39a-03d52299707e"
+Random = "9a3f8284-a2c9-5f02-9a11-845980a1fd5c"
+RecipesBase = "3cdcf5f2-1ef4-517c-9805-6587b60abb01"
+SparseArrays = "2f01184e-e22b-5df5-ae63-d93ebab69eaf"
+Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
+
+[compat]
+Documenter = "0.26"
+LinearMaps = "3"
+RecipesBase = "1"

test/bicgstabl.jl

@@ -1,3 +1,5 @@
+module TestBiCGStabl
+
 using IterativeSolvers
 using Test
 using Random
@@ -66,3 +68,5 @@ end
     end
 end
 end
+
+end # module

test/cg.jl

@@ -1,3 +1,5 @@
+module TestCG
+
 using IterativeSolvers
 using LinearMaps
 using Test
@@ -120,3 +122,5 @@ end
 end
 
 end
+
+end # module

test/chebyshev.jl

@@ -1,3 +1,5 @@
+module TestChebyshev
+
 using IterativeSolvers
 using Test
 using Random
@@ -91,3 +93,5 @@ end
     end
 end
 end
+
+end # module

test/common.jl

@@ -1,3 +1,6 @@
+module TestCommon
+
+using Documenter
 using LinearAlgebra
 using IterativeSolvers
 using Test
@@ -25,3 +28,8 @@ end
 end
 
 end
+
+DocMeta.setdocmeta!(IterativeSolvers, :DocTestSetup, :(using IterativeSolvers); recursive=true)
+doctest(IterativeSolvers, manual=true)
+
+end # module

test/deprecations.jl

@@ -1,3 +1,5 @@
+module TestDeprecations
+
 using IterativeSolvers
 using Test
 
@@ -12,4 +14,6 @@ using Test
     @test_deprecated idrs(A, b, tol=1.0, maxiter=1)
     @test_deprecated minres(A, b, tol=1.0, maxiter=1)
     @test_deprecated qmr(A, b, tol=1.0, maxiter=1)
-end
+end
+
+end # module