lazylabel-gui 1.1.1__tar.gz → 1.1.3__tar.gz

{lazylabel_gui-1.1.1/src/lazylabel_gui.egg-info → lazylabel_gui-1.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lazylabel-gui
-Version: 1.1.1
+Version: 1.1.3
 Summary: An image segmentation GUI for generating ML ready mask tensors and annotations.
 Author-email: "Deniz N. Cakan" <deniz.n.cakan@gmail.com>
 License: MIT License
@@ -45,6 +45,12 @@ Requires-Dist: opencv-python>=4.11.0.86
 Requires-Dist: scipy>=1.15.3
 Requires-Dist: requests>=2.32.4
 Requires-Dist: tqdm>=4.67.1
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
+Requires-Dist: pytest-qt>=4.2.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
 Dynamic: license-file
 
 # <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo2.png" alt="LazyLabel Logo" style="height:60px; vertical-align:middle;" /> <img src="https://raw.githubusercontent.com/dnzckn/LazyLabel/main/src/lazylabel/demo_pictures/logo_black.png" alt="LazyLabel Cursive" style="height:60px; vertical-align:middle;" />
@@ -142,7 +148,8 @@ Inspired by [LabelMe](https://github.com/wkentaro/labelme?tab=readme-ov-file#ins
 |---|---|
 | `L-Click` | Add positive point (Point Mode) or polygon vertex. |
 | `R-Click` | Add negative point (Point Mode). |
-| `Ctrl + Z` | Undo last point. |
+| `Ctrl + Z` | Undo last action. |
+| `Ctrl + Y` / `Ctrl + Shift + Z` | Redo last action. |
 | `Spacebar` | Finalize and save current AI segment. |
 | `Enter` | **Save final mask for the current image to a `.npz` file.** |
 | `M` | **Merge** selected segments into a single class. |
@@ -191,6 +198,45 @@ LazyLabel includes a comprehensive hotkey management system:
 
 For complete hotkey documentation, see [HOTKEY_FEATURE.md](src/lazylabel/HOTKEY_FEATURE.md).
 
+## Development
+
+### Code Quality
+This project uses Ruff for linting and formatting:
+
+```bash
+# Activate virtual environment first
+& e:\venv\lazylabel\Scripts\Activate.ps1
+
+# Run linter
+ruff check .
+
+# Fix auto-fixable issues
+ruff check --fix .
+
+# Format code
+ruff format .
+
+# Check if code is properly formatted
+ruff format --check .
+```
+
+### Testing
+
+Run tests using pytest:
+
+```bash
+# Run all tests
+python -m pytest
+
+# Run tests with coverage
+python -m pytest --cov=lazylabel --cov-report=html --cov-report=term-missing
+
+# Run specific test file
+python -m pytest tests/unit/ui/test_undo_redo.py -v
+```
+
+The HTML coverage report will be generated in `htmlcov/` directory.
+
 ---
 
 ## ☕ Support LazyLabel

{lazylabel_gui-1.1.1 → lazylabel_gui-1.1.3}/README.md

@@ -93,7 +93,8 @@ Inspired by [LabelMe](https://github.com/wkentaro/labelme?tab=readme-ov-file#ins
 |---|---|
 | `L-Click` | Add positive point (Point Mode) or polygon vertex. |
 | `R-Click` | Add negative point (Point Mode). |
-| `Ctrl + Z` | Undo last point. |
+| `Ctrl + Z` | Undo last action. |
+| `Ctrl + Y` / `Ctrl + Shift + Z` | Redo last action. |
 | `Spacebar` | Finalize and save current AI segment. |
 | `Enter` | **Save final mask for the current image to a `.npz` file.** |
 | `M` | **Merge** selected segments into a single class. |
@@ -142,7 +143,46 @@ LazyLabel includes a comprehensive hotkey management system:
 
 For complete hotkey documentation, see [HOTKEY_FEATURE.md](src/lazylabel/HOTKEY_FEATURE.md).
 
+## Development
+
+### Code Quality
+This project uses Ruff for linting and formatting:
+
+```bash
+# Activate virtual environment first
+& e:\venv\lazylabel\Scripts\Activate.ps1
+
+# Run linter
+ruff check .
+
+# Fix auto-fixable issues
+ruff check --fix .
+
+# Format code
+ruff format .
+
+# Check if code is properly formatted
+ruff format --check .
+```
+
+### Testing
+
+Run tests using pytest:
+
+```bash
+# Run all tests
+python -m pytest
+
+# Run tests with coverage
+python -m pytest --cov=lazylabel --cov-report=html --cov-report=term-missing
+
+# Run specific test file
+python -m pytest tests/unit/ui/test_undo_redo.py -v
+```
+
+The HTML coverage report will be generated in `htmlcov/` directory.
+
 ---
 
 ## ☕ Support LazyLabel
-[If you found LazyLabel helpful, consider supporting the project!](https://buymeacoffee.com/dnzckn)
+[If you found LazyLabel helpful, consider supporting the project!](https://buymeacoffee.com/dnzckn)

lazylabel_gui-1.1.3/pyproject.toml

@@ -0,0 +1,93 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lazylabel-gui"
+version = "1.1.3"
+authors = [
+  { name="Deniz N. Cakan", email="deniz.n.cakan@gmail.com" },
+]
+description = "An image segmentation GUI for generating ML ready mask tensors and annotations."
+readme = "README.md"
+license = { file="LICENSE" }
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Image Processing",
+    "Environment :: X11 Applications :: Qt",
+]
+dependencies = [
+    "PyQt6>=6.9.0",
+    "pyqtdarktheme==2.1.0",
+    "torch>=2.7.1",
+    "torchvision>=0.22.1",
+    "segment-anything==1.0",
+    "numpy>=2.1.2",
+    "opencv-python>=4.11.0.86",
+    "scipy>=1.15.3",
+    "requests>=2.32.4",
+    "tqdm>=4.67.1"
+]
+
+[project.urls]
+"Homepage" = "https://github.com/dnzckn/lazylabel"
+"Bug Tracker" = "https://github.com/dnzckn/lazylabel/issues"
+
+[project.scripts]
+lazylabel-gui = "lazylabel.main:main"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "pytest-mock>=3.10.0",
+    "pytest-qt>=4.2.0",
+    "ruff>=0.8.0",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+
+[tool.ruff]
+target-version = "py310"
+line-length = 88
+exclude = [
+    ".git",
+    ".pytest_cache",
+    "__pycache__",
+    "dist",
+    "build",
+    "*.egg-info",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",    # pycodestyle errors
+    "W",    # pycodestyle warnings
+    "F",    # pyflakes
+    "I",    # isort
+    "B",    # flake8-bugbear
+    "C4",   # flake8-comprehensions
+    "UP",   # pyupgrade
+    "SIM",  # flake8-simplify
+]
+ignore = [
+    "E501",  # line too long, handled by formatter
+    "B008",  # do not perform function calls in argument defaults
+    "C901",  # too complex
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*" = ["B011", "S101"]  # Allow assert statements in tests
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "auto"

{lazylabel_gui-1.1.1 → lazylabel_gui-1.1.3}/src/lazylabel/__init__.py

@@ -6,4 +6,4 @@ __email__ = "deniz.n.cakan@gmail.com"
 
 from .main import main
 
-__all__ = ['main']
+__all__ = ["main"]

lazylabel_gui-1.1.3/src/lazylabel/config/__init__.py

@@ -0,0 +1,7 @@
+"""Configuration management for LazyLabel."""
+
+from .hotkeys import HotkeyAction, HotkeyManager
+from .paths import Paths
+from .settings import DEFAULT_SETTINGS, Settings
+
+__all__ = ["Settings", "DEFAULT_SETTINGS", "Paths", "HotkeyManager", "HotkeyAction"]

{lazylabel_gui-1.1.1 → lazylabel_gui-1.1.3}/src/lazylabel/config/hotkeys.py

@@ -2,89 +2,127 @@
 
 import json
 import os
-from dataclasses import dataclass, asdict
-from typing import Dict, Optional, List, Tuple
-from PyQt6.QtCore import Qt
+from dataclasses import dataclass
+
 from PyQt6.QtGui import QKeySequence
 
 
 @dataclass
 class HotkeyAction:
     """Represents a hotkey action with primary and secondary keys."""
+
     name: str
     description: str
     primary_key: str
-    secondary_key: Optional[str] = None
+    secondary_key: str | None = None
     category: str = "General"
     mouse_related: bool = False  # Cannot be reassigned if True
 
 
 class HotkeyManager:
     """Manages application hotkeys with persistence."""
-    
+
     def __init__(self, config_dir: str):
         self.config_dir = config_dir
         self.hotkeys_file = os.path.join(config_dir, "hotkeys.json")
-        self.actions: Dict[str, HotkeyAction] = {}
+        self.actions: dict[str, HotkeyAction] = {}
         self._initialize_default_hotkeys()
         self.load_hotkeys()
-    
+
     def _initialize_default_hotkeys(self):
         """Initialize default hotkey mappings."""
         default_hotkeys = [
             # Navigation
-            HotkeyAction("load_next_image", "Load Next Image", "Right", category="Navigation"),
-            HotkeyAction("load_previous_image", "Load Previous Image", "Left", category="Navigation"),
-            HotkeyAction("fit_view", "Fit View", "Period", category="Navigation"),
-            
+            HotkeyAction(
+                "load_next_image", "Load Next Image", "Right", category="Navigation"
+            ),
+            HotkeyAction(
+                "load_previous_image",
+                "Load Previous Image",
+                "Left",
+                category="Navigation",
+            ),
+            HotkeyAction("fit_view", "Fit View", ".", category="Navigation"),
             # Modes
             HotkeyAction("sam_mode", "Point Mode (SAM)", "1", category="Modes"),
             HotkeyAction("polygon_mode", "Polygon Mode", "2", category="Modes"),
             HotkeyAction("selection_mode", "Selection Mode", "E", category="Modes"),
             HotkeyAction("pan_mode", "Pan Mode", "Q", category="Modes"),
             HotkeyAction("edit_mode", "Edit Mode", "R", category="Modes"),
-            
             # Actions
-            HotkeyAction("clear_points", "Clear Points/Vertices", "C", category="Actions"),
-            HotkeyAction("save_segment", "Save Current Segment", "Space", category="Actions"),
+            HotkeyAction(
+                "clear_points", "Clear Points/Vertices", "C", category="Actions"
+            ),
+            HotkeyAction(
+                "save_segment", "Save Current Segment", "Space", category="Actions"
+            ),
             HotkeyAction("save_output", "Save Output", "Return", category="Actions"),
-            HotkeyAction("save_output_alt", "Save Output (Alt)", "Enter", category="Actions"),
+            HotkeyAction(
+                "save_output_alt", "Save Output (Alt)", "Enter", category="Actions"
+            ),
             HotkeyAction("undo", "Undo Last Action", "Ctrl+Z", category="Actions"),
-            HotkeyAction("escape", "Cancel/Clear Selection", "Escape", category="Actions"),
-            
+            HotkeyAction(
+                "redo", "Redo Last Action", "Ctrl+Y", "Ctrl+Shift+Z", category="Actions"
+            ),
+            HotkeyAction(
+                "escape", "Cancel/Clear Selection", "Escape", category="Actions"
+            ),
             # Segments
-            HotkeyAction("merge_segments", "Merge Selected Segments", "M", category="Segments"),
-            HotkeyAction("delete_segments", "Delete Selected Segments", "V", category="Segments"),
-            HotkeyAction("delete_segments_alt", "Delete Selected Segments (Alt)", "Backspace", category="Segments"),
-            HotkeyAction("select_all", "Select All Segments", "Ctrl+A", category="Segments"),
-            
+            HotkeyAction(
+                "merge_segments", "Merge Selected Segments", "M", category="Segments"
+            ),
+            HotkeyAction(
+                "delete_segments", "Delete Selected Segments", "V", category="Segments"
+            ),
+            HotkeyAction(
+                "delete_segments_alt",
+                "Delete Selected Segments (Alt)",
+                "Backspace",
+                category="Segments",
+            ),
+            HotkeyAction(
+                "select_all", "Select All Segments", "Ctrl+A", category="Segments"
+            ),
             # View
             HotkeyAction("zoom_in", "Zoom In", "Ctrl+Plus", category="View"),
             HotkeyAction("zoom_out", "Zoom Out", "Ctrl+Minus", category="View"),
-            
             # Movement (WASD)
             HotkeyAction("pan_up", "Pan Up", "W", category="Movement"),
             HotkeyAction("pan_down", "Pan Down", "S", category="Movement"),
             HotkeyAction("pan_left", "Pan Left", "A", category="Movement"),
             HotkeyAction("pan_right", "Pan Right", "D", category="Movement"),
-            
             # Mouse-related (cannot be reassigned)
-            HotkeyAction("left_click", "Add Positive Point / Select", "Left Click", 
-                        category="Mouse", mouse_related=True),
-            HotkeyAction("right_click", "Add Negative Point", "Right Click", 
-                        category="Mouse", mouse_related=True),
-            HotkeyAction("mouse_drag", "Drag/Pan", "Mouse Drag", 
-                        category="Mouse", mouse_related=True),
+            HotkeyAction(
+                "left_click",
+                "Add Positive Point / Select",
+                "Left Click",
+                category="Mouse",
+                mouse_related=True,
+            ),
+            HotkeyAction(
+                "right_click",
+                "Add Negative Point",
+                "Right Click",
+                category="Mouse",
+                mouse_related=True,
+            ),
+            HotkeyAction(
+                "mouse_drag",
+                "Drag/Pan",
+                "Mouse Drag",
+                category="Mouse",
+                mouse_related=True,
+            ),
         ]
-        
+
         for action in default_hotkeys:
             self.actions[action.name] = action
-    
-    def get_action(self, action_name: str) -> Optional[HotkeyAction]:
+
+    def get_action(self, action_name: str) -> HotkeyAction | None:
         """Get hotkey action by name."""
         return self.actions.get(action_name)
-    
-    def get_actions_by_category(self) -> Dict[str, List[HotkeyAction]]:
+
+    def get_actions_by_category(self) -> dict[str, list[HotkeyAction]]:
         """Get actions grouped by category."""
         categories = {}
         for action in self.actions.values():
@@ -92,29 +130,29 @@ class HotkeyManager:
                 categories[action.category] = []
             categories[action.category].append(action)
         return categories
-    
+
     def set_primary_key(self, action_name: str, key: str) -> bool:
         """Set primary key for an action."""
         if action_name in self.actions and not self.actions[action_name].mouse_related:
             self.actions[action_name].primary_key = key
             return True
         return False
-    
-    def set_secondary_key(self, action_name: str, key: Optional[str]) -> bool:
+
+    def set_secondary_key(self, action_name: str, key: str | None) -> bool:
         """Set secondary key for an action."""
         if action_name in self.actions and not self.actions[action_name].mouse_related:
             self.actions[action_name].secondary_key = key
             return True
         return False
-    
-    def get_key_for_action(self, action_name: str) -> Tuple[Optional[str], Optional[str]]:
+
+    def get_key_for_action(self, action_name: str) -> tuple[str | None, str | None]:
         """Get primary and secondary keys for an action."""
         action = self.actions.get(action_name)
         if action:
             return action.primary_key, action.secondary_key
         return None, None
-    
-    def is_key_in_use(self, key: str, exclude_action: str = None) -> Optional[str]:
+
+    def is_key_in_use(self, key: str, exclude_action: str = None) -> str | None:
         """Check if a key is already in use by another action."""
         for name, action in self.actions.items():
             if name == exclude_action:
@@ -122,48 +160,48 @@ class HotkeyManager:
             if action.primary_key == key or action.secondary_key == key:
                 return name
         return None
-    
+
     def reset_to_defaults(self):
         """Reset all hotkeys to default values."""
         self._initialize_default_hotkeys()
-    
+
     def save_hotkeys(self):
         """Save hotkeys to file."""
         os.makedirs(self.config_dir, exist_ok=True)
-        
+
         # Convert to serializable format
         data = {}
         for name, action in self.actions.items():
             if not action.mouse_related:  # Don't save mouse-related actions
                 data[name] = {
-                    'primary_key': action.primary_key,
-                    'secondary_key': action.secondary_key
+                    "primary_key": action.primary_key,
+                    "secondary_key": action.secondary_key,
                 }
-        
-        with open(self.hotkeys_file, 'w') as f:
+
+        with open(self.hotkeys_file, "w") as f:
             json.dump(data, f, indent=4)
-    
+
     def load_hotkeys(self):
         """Load hotkeys from file."""
         if not os.path.exists(self.hotkeys_file):
             return
-        
+
         try:
-            with open(self.hotkeys_file, 'r') as f:
+            with open(self.hotkeys_file) as f:
                 data = json.load(f)
-            
+
             for name, keys in data.items():
                 if name in self.actions and not self.actions[name].mouse_related:
-                    self.actions[name].primary_key = keys.get('primary_key', '')
-                    self.actions[name].secondary_key = keys.get('secondary_key')
+                    self.actions[name].primary_key = keys.get("primary_key", "")
+                    self.actions[name].secondary_key = keys.get("secondary_key")
         except (json.JSONDecodeError, KeyError, FileNotFoundError):
             # If loading fails, keep defaults
             pass
-    
+
     def key_sequence_to_string(self, key_sequence: QKeySequence) -> str:
         """Convert QKeySequence to string representation."""
         return key_sequence.toString()
-    
+
     def string_to_key_sequence(self, key_string: str) -> QKeySequence:
         """Convert string to QKeySequence."""
-        return QKeySequence(key_string)
+        return QKeySequence(key_string)

{lazylabel_gui-1.1.1 → lazylabel_gui-1.1.3}/src/lazylabel/config/paths.py

@@ -1,41 +1,40 @@
 """Path management for LazyLabel."""
 
-import os
 from pathlib import Path
 
 
 class Paths:
     """Centralized path management."""
-    
+
     def __init__(self):
         self.app_dir = Path(__file__).parent.parent
         self.models_dir = self.app_dir / "models"
         self.config_dir = Path.home() / ".config" / "lazylabel"
         self.cache_dir = Path.home() / ".cache" / "lazylabel"
-        
+
         # Ensure directories exist
         self.models_dir.mkdir(exist_ok=True)
         self.config_dir.mkdir(parents=True, exist_ok=True)
-        
+
     @property
     def settings_file(self) -> Path:
         """Path to settings file."""
         return self.config_dir / "settings.json"
-    
+
     @property
     def demo_pictures_dir(self) -> Path:
         """Path to demo pictures directory."""
         return self.app_dir / "demo_pictures"
-    
+
     @property
     def logo_path(self) -> Path:
         """Path to application logo."""
         return self.demo_pictures_dir / "logo2.png"
-    
+
     def get_model_path(self, filename: str) -> Path:
         """Get path for a model file."""
         return self.models_dir / filename
-    
+
     def get_old_cache_model_path(self, filename: str) -> Path:
         """Get path for model in old cache location."""
-        return self.cache_dir / filename
+        return self.cache_dir / filename

{lazylabel_gui-1.1.1 → lazylabel_gui-1.1.3}/src/lazylabel/config/settings.py

@@ -1,60 +1,59 @@
 """Application settings and configuration."""
 
-import os
-from dataclasses import dataclass, asdict
-from typing import Dict, Any
 import json
+import os
+from dataclasses import asdict, dataclass
 
 
 @dataclass
 class Settings:
     """Application settings with defaults."""
-    
+
     # UI Settings
     window_width: int = 1600
     window_height: int = 900
     left_panel_width: int = 250
     right_panel_width: int = 350
-    
+
     # Annotation Settings
     point_radius: float = 0.3
     line_thickness: float = 0.5
     pan_multiplier: float = 1.0
     polygon_join_threshold: int = 2
-    
+
     # Model Settings
     default_model_type: str = "vit_h"
     default_model_filename: str = "sam_vit_h_4b8939.pth"
-    
+
     # Save Settings
     auto_save: bool = True
     save_npz: bool = True
     save_txt: bool = True
     save_class_aliases: bool = False
     yolo_use_alias: bool = True
-    
+
     # UI State
     annotation_size_multiplier: float = 1.0
-    
+
     def save_to_file(self, filepath: str) -> None:
         """Save settings to JSON file."""
         os.makedirs(os.path.dirname(filepath), exist_ok=True)
-        with open(filepath, 'w') as f:
+        with open(filepath, "w") as f:
             json.dump(asdict(self), f, indent=4)
-    
+
     @classmethod
-    def load_from_file(cls, filepath: str) -> 'Settings':
+    def load_from_file(cls, filepath: str) -> "Settings":
         """Load settings from JSON file."""
         if not os.path.exists(filepath):
             return cls()
-        
+
         try:
-            with open(filepath, 'r') as f:
+            with open(filepath) as f:
                 data = json.load(f)
             return cls(**data)
         except (json.JSONDecodeError, TypeError):
             return cls()
-    
+
     def update(self, **kwargs) -> None:
         """Update settings with new values."""
         for key, value in kwargs.items():
@@ -63,4 +62,4 @@ class Settings:
 
 
 # Default settings instance
-DEFAULT_SETTINGS = Settings()
+DEFAULT_SETTINGS = Settings()

{lazylabel_gui-1.1.1 → lazylabel_gui-1.1.3}/src/lazylabel/core/__init__.py

@@ -1,7 +1,7 @@
 """Core business logic for LazyLabel."""
 
-from .segment_manager import SegmentManager
-from .model_manager import ModelManager
 from .file_manager import FileManager
+from .model_manager import ModelManager
+from .segment_manager import SegmentManager
 
-__all__ = ['SegmentManager', 'ModelManager', 'FileManager']
+__all__ = ["SegmentManager", "ModelManager", "FileManager"]