Version 1.4.1:

refactor(dataclasses): remove enabled param from SearchWindowSettings class
refactor: remove some comments with too obvious information

Author: KiTant

CTkCodeBoxPlus/__init__.py

@@ -6,17 +6,18 @@
 Homepage: https://github.com/KiTant/CTkCodeBoxPlus
 """
 
-__version__ = '1.4'
+__version__ = '1.4.1'
 
 from .ctk_code_box import CTkCodeBox
 from .dataclasses import *
+from .constants import common_langs
 from .custom_exception_classes import *
 from .text_menu import TextMenu
 from .add_line_nums import AddLineNums
 from .keybinding import unregister_keybind, register_keybind
 from .search_replace_window import SearchReplaceWindow
 
-__all__ = ["CTkCodeBox", "HistorySettings", "MenuSettings", "NumberingSettings", "ReplaceResult", "TextMenu",
+__all__ = ["CTkCodeBox", "HistorySettings", "MenuSettings", "SearchWindowSettings", "NumberingSettings",
            "AddLineNums", "unregister_keybind", "register_keybind", "CTkCodeBoxError", "KeybindingSettings",
            "LanguageNotAvailableError", "ThemeNotAvailableError", "LexerError", "ConfigureBadType",
-           "SearchReplaceWindow"]
+           "SearchReplaceWindow", "ReplaceResult", "TextMenu", "common_langs"]

CTkCodeBoxPlus/add_line_nums.py

@@ -3,9 +3,7 @@
 
 
 class AddLineNums(TkLineNumbers):
-    """
-    Line numbers widget for CTkCodeBox (uses TkLineNumbers)
-    """
+    """Line numbers widget for CTkCodeBox (uses TkLineNumbers)"""
     def __init__(self,
                  master,
                  text_color=None,

CTkCodeBoxPlus/ctk_code_box.py

@@ -22,14 +22,12 @@
 
 class CTkCodeBox(customtkinter.CTkTextbox):
     """A code-oriented CTk textbox with syntax highlighting and UX helpers.
-
     CTkCodeBox wraps a CTkTextbox to provide:
     - Pygments-based syntax highlighting with theme support
     - Optional line numbers, smarter selection, and current-line highlight
     - Indentation helpers (Tab/Shift+Tab, auto-indent on Return)
     - Simple history (Undo/Redo) with typing cooldown
     - Platform-aware keybindings (Cmd on macOS, Ctrl elsewhere)
-
     Emits:
         <<ContentChanged>> on both the inner textbox and the wrapper whenever
         content changes via the provided APIs.
@@ -156,10 +154,8 @@ def __init__(self,
 
     def check_lexer(self):
         """Resolve and set the lexer.
-
         If `language` is a string, pick a lexer from common languages.
         otherwise treat `language` as a Pygments lexer class.
-
         Raises:
             LanguageNotAvailableError: When string language is unknown.
         """
@@ -173,7 +169,6 @@ def check_lexer(self):
 
     def configure_tags(self):
         """Configure all syntax tags for the current Pygments theme.
-
         Raises:
             ThemeNotAvailableError: If the requested theme is not installed.
         """
@@ -220,7 +215,6 @@ def _select_all(self):
 
     def insert(self, index, chars, push_history=True, *tags):
         """Insert text and trigger a non-editing highlight update.
-
         Mirrors tkinter.Text.insert signature to maintain API parity.
         """
         if push_history:
@@ -231,7 +225,6 @@ def insert(self, index, chars, push_history=True, *tags):
 
     def highlight_code(self, code):
         """Tokenize code with Pygments and apply tags.
-
         Raises:
             LexerError: If the provided lexer fails to tokenize the input.
         """
@@ -958,7 +951,6 @@ def _on_backtick(self, event=None):
 
     def _handle_chars_wrap(self, chars: str):
         """Handle wrapping/insertion behavior for paired characters.
-
         If text is selected, wraps it with the given pair. Otherwise inserts a
         paired sequence and places the caret between them.
         """
@@ -1086,7 +1078,6 @@ def _on_triple_click(self, event):
 
     def _expand_token_at_index(self, idx):
         """Return token span around index based on simple character classes.
-
         Returns:
             A tuple (start_index, end_index) or (None, None) when no token
             can be expanded at the given index.

CTkCodeBoxPlus/dataclasses.py

@@ -4,7 +4,6 @@
 
 @dataclass(frozen=True)
 class SearchWindowSettings:
-    enabled: bool = True
     title: str = "Search & Replace"
     width: int = 400
     height: int = 250
@@ -34,7 +33,8 @@ class MenuSettings:
     commands: dict = field(default_factory=lambda: {
         # label: (special type for states or "", callable or attribute of codebox in str, displaying accelerator,
         # additional check (callable with return or attr of codebox in str for cget) or None)
-        # or "separator": additional check (callable with return or attr of codebox in str for cget) or None
+        # or
+        # "separator": additional check (callable with return or attr of codebox in str for cget) or None
         "Copy": ("has_selection", "copy_text", "Ctrl+C", None),
         "Paste": ("has_clip", "paste_text", "Ctrl+V", None),
         "Cut": ("has_selection", "cut_text", "Ctrl+X", None),
@@ -75,7 +75,7 @@ class KeybindingSettings:  # If you want to disable keybind just write ""
     R_open_search_window: str = "CmdOrCtrl+F"
     # Indentation keybinds
     R__on_tab: str = "TAB"
-    # Use Shift-Tab for outdent;
+    # Use Shift-Tab for outdent
     R__on_shift_tab: str = "Shift+TAB"
     R__on_return: str = "RETURN"
     # Quote wrapping on selection

CTkCodeBoxPlus/keybinding.py

@@ -1,6 +1,5 @@
 """
 Keybinding system for customtkinter
-
 Provides layout-independent keyboard keybind registration that works across
 platforms and keyboard layouts by physical keycode logic.
 
@@ -15,7 +14,6 @@
     from .keybinding import unregister_keybind
     unregister_keybind(root, "CmdOrCtrl+P")              # remove all callbacks for this keybind on target
     unregister_keybind(entry, "Ctrl+Return", on_submit)  # remove specific callback
-
 Notes:
     - You can pass either a toplevel/root (tk.Tk, tk.Toplevel, CTk, CTkToplevel)
       or ANY Tk/CustomTkinter widget (e.g., CTkTextbox, CTkEntry).
@@ -68,7 +66,6 @@ def _get_platform_keymaps() -> Tuple[Dict[str, int], Dict[str, int]]:
 
 def _build_platform_keymaps() -> Tuple[Dict[str, int], Dict[str, int]]:
     """Return (function_keys, special_keys) dicts for the current platform.
-
     This centralizes platform keycodes to avoid duplication.
     """
     if sys.platform == 'win32':
@@ -90,10 +87,10 @@ def _build_platform_keymaps() -> Tuple[Dict[str, int], Dict[str, int]]:
             'ESCAPE': 27, 'ESC': 27,
             'SPACE': 32,
             'BACKSPACE': 8,
-            'PLUS': 187, 'EQUAL': 187, '=': 187,  # Main keyboard =/+ key
-            'NUMPAD_PLUS': 107, 'NUMPAD_ADD': 107,  # Numpad +
-            'MINUS': 189, 'HYPHEN': 189, '-': 189,  # Main keyboard -/_ key
-            'NUMPAD_MINUS': 109, 'NUMPAD_SUBTRACT': 109,  # Numpad -
+            'PLUS': 187, 'EQUAL': 187, '=': 187,
+            'NUMPAD_PLUS': 107, 'NUMPAD_ADD': 107,
+            'MINUS': 189, 'HYPHEN': 189, '-': 189,
+            'NUMPAD_MINUS': 109, 'NUMPAD_SUBTRACT': 109,
             'COMMA': 188, ',': 188,
             'PERIOD': 190, '.': 190
         }
@@ -106,7 +103,7 @@ def _build_platform_keymaps() -> Tuple[Dict[str, int], Dict[str, int]]:
         }
         special_keys = {
             'DELETE': 117, 'DEL': 117,  # Forward Delete (both unified)
-            'BACKSPACE': 51,  # Backspace key
+            'BACKSPACE': 51,
             'INSERT': 114,
             'HOME': 115, 'END': 119,
             'PAGE_UP': 116, 'PAGEUP': 116, 'PGUP': 116,
@@ -116,10 +113,10 @@ def _build_platform_keymaps() -> Tuple[Dict[str, int], Dict[str, int]]:
             'ENTER': 36, 'RETURN': 76,  # keypad Enter = 76
             'ESCAPE': 53, 'ESC': 53,
             'SPACE': 49,
-            'PLUS': 69, 'EQUAL': 69, '=': 69,  # Main keyboard =/+ key
-            'NUMPAD_PLUS': 78, 'NUMPAD_ADD': 78,  # Numpad +
-            'MINUS': 27, 'HYPHEN': 27, '-': 27,  # Main keyboard -/_ key
-            'NUMPAD_MINUS': 75, 'NUMPAD_SUBTRACT': 75,  # Numpad -
+            'PLUS': 69, 'EQUAL': 69, '=': 69,
+            'NUMPAD_PLUS': 78, 'NUMPAD_ADD': 78,
+            'MINUS': 27, 'HYPHEN': 27, '-': 27,
+            'NUMPAD_MINUS': 75, 'NUMPAD_SUBTRACT': 75,
             'COMMA': 43, ',': 43,
             'PERIOD': 47, '.': 47
         }
@@ -142,10 +139,10 @@ def _build_platform_keymaps() -> Tuple[Dict[str, int], Dict[str, int]]:
             'ESCAPE': 9, 'ESC': 9,
             'SPACE': 65,
             'BACKSPACE': 22,
-            'PLUS': 21, 'EQUAL': 21, '=': 21,  # Main keyboard =/+ key
-            'NUMPAD_PLUS': 86, 'NUMPAD_ADD': 86,  # Numpad +
-            'MINUS': 20, 'HYPHEN': 20, '-': 20,  # Main keyboard -/_ key
-            'NUMPAD_MINUS': 82, 'NUMPAD_SUBTRACT': 82,  # Numpad -
+            'PLUS': 21, 'EQUAL': 21, '=': 21,
+            'NUMPAD_PLUS': 86, 'NUMPAD_ADD': 86,
+            'MINUS': 20, 'HYPHEN': 20, '-': 20,
+            'NUMPAD_MINUS': 82, 'NUMPAD_SUBTRACT': 82,
             'COMMA': 59, ',': 59,
             'PERIOD': 60, '.': 60
         }
@@ -179,7 +176,6 @@ def _get_group_id(widget: Any) -> int:
 
 def _parse_modifiers(mod_tokens: List[str]) -> Tuple[str, List[str]]:
     """Normalize a list of modifier tokens into a canonical key and Tk names.
-
     Returns:
         mods_key: canonical string like 'ctrl', 'ctrl+shift', or 'none'
         tk_mods: list of Tk modifier names like ['Control', 'Shift']
@@ -222,11 +218,9 @@ def _parse_modifiers(mod_tokens: List[str]) -> Tuple[str, List[str]]:
 
 def register_keybind(widget_or_root: Any, keybind: str, callback: Callable, *, bind_scope: str = 'window') -> None:
     """Register a keyboard keybind that works regardless of keyboard layout.
-
     Supported Modifiers: Ctrl, Alt, Shift, Cmd (macOS)
     Supported Keys: A-Z, 0-9, F1-F12, Delete, Insert, Home, End, Page_Up, Page_Down, etc.
     Supports both single keys (F1, F2, Delete) and modified keys (Ctrl+S, Alt+F4)
-
     Args:
         widget_or_root: Any Tk/CustomTkinter widget or a toplevel/root.
         keybind: Keybind string in format 'Modifier+Key' or just 'Key' (e.g., "Ctrl+S", "Alt+F4", "F1")
@@ -402,13 +396,11 @@ def _on_destroy(event, t_id=target_id, tgt=target):
 
 def unregister_keybind(widget_or_root: Any, keybind: str, callback: Callable | None = None, *, bind_scope: str = 'window') -> bool:
     """Unregister keybind from a window or a specific widget.
-
     Args:
         widget_or_root: Any Tk/CustomTkinter widget or a toplevel/root.
         keybind: Keybind string 'Modifier+Key' or just 'Key'. Supports 'CmdOrCtrl'.
         callback: Optional specific callback to remove. If None, removes all callbacks for this keybind.
         bind_scope: 'window' to target the widget's toplevel, or 'widget' to target only the widget.
-
     Returns:
         True if something was removed, False otherwise.
     """

CTkCodeBoxPlus/text_menu.py

@@ -110,14 +110,14 @@ def _update_states(self):
         except tkinter.TclError:
             has_redo = False
 
-        # Apply states
         def set_state(label, enabled):
             try:
                 self.entryconfig(label, state=("normal" if enabled else "disabled"))
             except Exception:
                 pass
 
-        states = {"has_selection": has_selection, "has_clip": has_clip, "has_text": has_text, "has_undo": has_undo, "has_redo": has_redo}
+        states = {"has_selection": has_selection, "has_clip": has_clip, "has_text": has_text,
+                  "has_undo": has_undo, "has_redo": has_redo}
         for state, labels in self.labels_states.items():
             for label in labels:
                 set_state(label, states[state])

README.md

@@ -90,7 +90,6 @@ root.mainloop()
 ```python
 @dataclass(frozen=True)
 class SearchWindowSettings:
-    enabled: bool = True
     title: str = "Search & Replace"
     width: int = 400
     height: int = 250
@@ -119,7 +118,8 @@ class MenuSettings:
     commands: dict = field(default_factory=lambda: {
         # label: (special type for states or "", callable or attribute of codebox in str, displaying accelerator,
         # additional check (callable with return or attr of codebox in str for cget) or None)
-        # or "separator": additional check (callable with return or attr of codebox in str for cget) or None
+        # or 
+        # "separator": additional check (callable with return or attr of codebox in str for cget) or None
         "Copy": ("has_selection", "copy_text", "Ctrl+C", None),
         "Paste": ("has_clip", "paste_text", "Ctrl+V", None),
         "Cut": ("has_selection", "cut_text", "Ctrl+X", None),
@@ -156,7 +156,7 @@ class KeybindingSettings:  # If you want to disable keybind just write ""
     R_undo: str = "CmdOrCtrl+Z"
     # Indentation keybinds
     R__on_tab: str = "TAB"
-    # Use Shift-Tab for outdent;
+    # Use Shift-Tab for outdent
     R__on_shift_tab: str = "Shift+TAB"
     R__on_return: str = "RETURN"
     # Quote wrapping on selection

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "CTkCodeBoxPlus"
-version = "1.4"
+version = "1.4.1"
 description = "A code editor widget for customtkinter with enhanced features"
 readme = "README.md"
 license = {file = "LICENSE"}

theme_example.py

@@ -1,16 +1,13 @@
 import customtkinter
 from CTkCodeBoxPlus import *
 
-# Create the main application window
 app = customtkinter.CTk()
 app.geometry("400x400")
 app.title("CodeBox Themes")
 
-# Create a CTkLabel to display a title
 title_label = customtkinter.CTkLabel(app, text="CodeBox Examples", font=("Helvetica", 16, "bold"))
 title_label.pack()
 
-# Create a CTkCodeBox with an initial theme
 codebox = CTkCodeBox(app, language="python", theme="solarized-light")
 codebox.pack(padx=10, pady=10, fill="both", expand=True)
 demo_code = """def is_prime(num):
@@ -32,7 +29,6 @@
 """
 codebox.insert("0.0", demo_code, push_history=False)
 
-# Create a CTkComboBox for theme selection
 theme_values = ['abap', 'arduino', 'autumn', 'borland',
                 'colorful', 'default', 'dracula', 'emacs', 'friendly_grayscale',
                 'friendly', 'fruity', 'github-dark', 'gruvbox-dark', 'gruvbox-light',