add "verbosity" preference and default_verbosity()

oops

Author: ablaom

.gitignore

@@ -8,3 +8,4 @@ sandbox/
 /docs/site/
 /docs/Manifest.toml
 .vscode
+LocalPreferences.toml

Project.toml

@@ -1,13 +1,17 @@
+authors = ["Anthony D. Blaom <anthony.blaom@gmail.com>"]
 name = "LearnAPI"
 uuid = "92ad9a40-7767-427a-9ee6-6e577f1266cb"
-authors = ["Anthony D. Blaom <anthony.blaom@gmail.com>"]
 version = "2.0.0"
 
 [compat]
+Preferences = "1.5.0"
 julia = "1.10"
 
+[deps]
+Preferences = "21216c6a-2e73-6563-6e65-726566657250"
+
 [extras]
 Test = "8dfed614-e22c-5e08-85e1-65c5234f0b40"
 
 [targets]
-test = ["Test",]
+test = ["Test"]

src/LearnAPI.jl

@@ -1,5 +1,8 @@
 module LearnAPI
 
+using Preferences
+
+include("preferences.jl")
 include("types.jl")
 include("tools.jl")
 include("predict_transform.jl")

src/preferences.jl

@@ -0,0 +1,30 @@
+const VERBOSITY = @load_preference "verbosity" 1
+
+INFO_VERBOSITY_IS(verbosity) =
+    "Currently the baseline verbosity is $verbosity. "
+INFO_VERBOSITY_WILL_BE(verbosity) =
+    "After restarting Julia, this will be changed to $verbosity. "
+
+"""
+    LearnAPI.default_verbosity()
+
+Return the default verbosity for training LearnAPI learners.
+
+The value is determined at compile time by a Preferences.jl-style preference, with key
+"verbosity".
+
+"""
+default_verbosity() = VERBOSITY
+
+"""
+    LearnAPI.default_verbosity(level)
+
+Set the default verbosity for training LearnAPI learners to `level`. Changes do not take
+effect until the next Julia session.
+
+"""
+function default_verbosity(level)
+    @info INFO_VERBOSITY_IS(VERBOSITY)
+    @set_preferences! "verbosity" => level
+    @info INFO_VERBOSITY_WILL_BE(level)
+end

test/preferences.jl

@@ -0,0 +1,21 @@
+using LearnAPI
+using Preferences
+
+@testset "default_verbosity" begin
+    @test LearnAPI.default_verbosity() == LearnAPI.VERBOSITY
+    @test_logs(
+        (:info, LearnAPI.INFO_VERBOSITY_IS(LearnAPI.default_verbosity())),
+        (:info, LearnAPI.INFO_VERBOSITY_WILL_BE(3)),
+        LearnAPI.default_verbosity(3),
+    )
+    @test load_preference(LearnAPI, "verbosity") == 3
+
+    # restore active preference:
+    @test_logs(
+        (:info, LearnAPI.INFO_VERBOSITY_IS(LearnAPI.default_verbosity())),
+        (:info, LearnAPI.INFO_VERBOSITY_WILL_BE(LearnAPI.VERBOSITY)),
+        LearnAPI.default_verbosity(LearnAPI.VERBOSITY),
+    )
+end
+
+true

test/runtests.jl

@@ -1,6 +1,7 @@
 using Test
 
 test_files = [
+    "preferences.jl",
     "tools.jl",
     "traits.jl",
     "clone.jl",