25 lines
1.5 KiB
Markdown
25 lines
1.5 KiB
Markdown
# AGENTS.md - Modus Desktop Environment
|
|
|
|
## Project Overview
|
|
- **Technology**: Python desktop environment using Fabric framework (GTK/PyGObject)
|
|
- **Purpose**: Wayland desktop environment with launcher, panel, dock, notifications
|
|
- **Entry Point**: `main.py` - starts all components
|
|
|
|
## Build/Test Commands
|
|
- **Run Application**: `python main.py`
|
|
- **Test Icon Browser**: `python test.py`
|
|
- **Install Dependencies**: `pip install -r requirements.txt`
|
|
- **No formal test suite exists** - test by running components directly
|
|
|
|
## Code Style Guidelines
|
|
- **Imports**: Standard library first, third-party second, local modules last with blank lines between groups
|
|
- **Formatting**: Follow PEP 8, use 4 spaces for indentation
|
|
- **Naming**: snake_case for functions/variables, PascalCase for classes, UPPER_CASE for constants
|
|
- **Type Hints**: Use typing imports for List, Optional, Tuple annotations
|
|
- **Error Handling**: Use try/except blocks, log errors with print statements or loguru logger
|
|
- **Comments**: Minimal docstrings for classes, no inline comments unless complex logic
|
|
- **Constants**: Define module-level constants at top (e.g., SEARCH_DEBOUNCE_MS = 50)
|
|
- **Properties**: Use @Property decorator with type hints for Fabric service properties
|
|
- **Signals**: Use @Signal decorator for event handling in services
|
|
- **Widget Structure**: Inherit from appropriate Fabric widgets (Window, Box, Entry, etc.)
|
|
- **GTK Integration**: Use gi.repository imports for GTK, GLib functionality |