1.3.2 global mode function + more tests alongside it. Also improved the README to be more catchy

Author: MattFor

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [1.3.2] - 2026-03-24
+
+### Added
+- set_mode() for setting the mode globally (f.e to education)
+- More tests for the global mode setting
+
+### Improved
+- README examples
+
 ## [1.3.1] - 2026-03-24
 
 ### Added

README.md

@@ -1,10 +1,11 @@
-![PyPI](https://img.shields.io/pypi/v/logeye?cachebust=1774326290)
+![PyPI](https://img.shields.io/pypi/v/logeye?cachebust=1774332497)
 ![Python](https://img.shields.io/pypi/pyversions/logeye)
 ![License](https://img.shields.io/github/license/MattFor/LogEye)
 
 # LogEye
 
 Understand exactly what your code is doing in real time, no debugger needed.  
+
 LogEye is a frictionless runtime logger for Python that shows variable changes, function calls, and data mutations as
 they happen.
 
@@ -150,8 +151,7 @@ Instead of raw internal logs, it shows:
 Enable it with:
 
 ```python
-from logeye import log
-from logeye.config import set_mode
+from logeye import log, set_mode
 
 # Globally
 set_mode("edu")
@@ -696,5 +696,5 @@ MIT License © 2026
 
 See [LICENSE](LICENSE) for details.
 
-Version 1.3.1
+Version 1.3.2
 

logeye/__init__.py

@@ -4,7 +4,7 @@
 from .core import log, watch
 from .formatting import set_output_formatter, reset_output_formatter
 from .config import toggle_logs, toggle_decorator_log_only, toggle_message_metadata, toggle_global_log_file, \
-	set_path_mode, set_global_log_file, _normalize_mode
+	set_mode, set_path_mode, set_global_log_file, _normalize_mode
 
 w = watch
 
@@ -21,6 +21,7 @@
 	"toggle_message_metadata",
 	"toggle_decorator_log_only",
 
+	"set_mode",
 	"set_path_mode",
 	"set_global_log_file",
 	"set_output_formatter",

logeye/config.py

@@ -70,6 +70,16 @@ def toggle_message_metadata(enabled: bool):
 #  SETTERS
 # =========
 
+def set_mode(mode: str):
+	"""
+	Set global logging mode
+	full or  edu / educational
+	"""
+
+	global _LOG_MODE
+	_LOG_MODE = _normalize_mode(mode)
+
+
 def set_global_log_file(filepath):
 	"""
 	Route LogEye output to this file globally.

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "logeye"
-version = "1.3.1"
+version = "1.3.2"
 description = "Frictionless runtime logging for Python variables and functions"
 readme = "README.md"
 requires-python = ">=3.10"

tests/test_educational.py

@@ -1,4 +1,4 @@
-from logeye import log
+from logeye import log, set_mode
 
 
 def test_call_formatting(capsys):
@@ -191,3 +191,63 @@ def simple():
 	assert "Added 1 to the end of arr" in out
 	assert "Added 2 to arr" in out
 	assert "Final: [3, 1, 2]" in out
+
+
+def test_global_mode_full(capsys):
+	set_mode("full")
+
+	try:
+		@log
+		def foo():
+			return 1
+
+		foo()
+
+		out = capsys.readouterr().out
+
+		assert "(call)" in out
+		assert "Calling" not in out
+	finally:
+		set_mode("full")
+
+
+def test_global_mode_edu(capsys):
+	set_mode("edu")
+
+	try:
+		@log
+		def foo():
+			return 1
+
+		foo()
+
+		out = capsys.readouterr().out
+
+		assert "Calling foo()" in out
+		assert "(call)" not in out
+	finally:
+		set_mode("full")
+
+
+def test_mode_toggle_mid_execution(capsys):
+	set_mode("full")
+
+	try:
+		@log
+		def foo():
+			a = 1  # full mode
+			set_mode("edu")
+			b = 2  # edu mode
+			set_mode("full")
+			c = 3  # back to full
+
+		foo()
+
+		out = capsys.readouterr().out
+
+		assert "(set)" in out or "foo.a" in out
+		assert "(set)" in out or "foo.c" in out
+		assert "b = 2" in out
+
+	finally:
+		set_mode("full")