175 lines
5.4 KiB
Markdown
175 lines
5.4 KiB
Markdown
|
# 🏷️ Tagger
|
||
|
|
|
||
|
|
Desktopová aplikace pro správu a organizaci souborů pomocí hierarchických tagů (štítků).
|
||
|
|
|
||
|
|
## ✨ Hlavní funkce
|
||
|
|
|
||
|
|
- 📁 Rekurzivní procházení složek
|
||
|
|
- 🏷️ Hierarchické tagy (kategorie/název)
|
||
|
|
- 🔍 Filtrování podle tagů a textu
|
||
|
|
- 💾 Metadata v JSON souborech (.!tag)
|
||
|
|
- 🎬 Automatická detekce rozlišení videí (ffprobe)
|
||
|
|
- 🎨 Dvě verze GUI: klasické a moderní (qBittorrent-style)
|
||
|
|
|
||
|
|
## 🚀 Rychlý start
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Instalace závislostí
|
||
|
|
poetry install
|
||
|
|
|
||
|
|
# Spuštění (moderní GUI)
|
||
|
|
poetry run python Tagger_modern.py
|
||
|
|
|
||
|
|
# Nebo klasické GUI
|
||
|
|
poetry run python Tagger.py
|
||
|
|
```
|
||
|
|
|
||
|
|
## 📸 Screenshot
|
||
|
|
|
||
|
|
### Moderní GUI (qBittorrent-style)
|
||
|
|
```
|
||
|
|
┌─────────────────────────────────────────────────────┐
|
||
|
|
│ 📁 Otevřít │ 🔄 │ 🏷️ │ 📅 🔍 [____] Toolbar
|
||
|
|
├────────────┬────────────────────────────────────────┤
|
||
|
|
│ 📂 Štítky │ Název │Datum│Štítky│Velikost │
|
||
|
|
│ ├─📁 Stav │ file1.txt│2025 │HD │1.2 MB │
|
||
|
|
│ │ ☑ Nové │ file2.mp4│ │4K │15 MB │
|
||
|
|
│ ├─📁 Video│ file3.jpg│ │RAW │845 KB │
|
||
|
|
│ │ ☐ HD │ │
|
||
|
|
├────────────┴────────────────────────────────────────┤
|
||
|
|
│ Připraven 3 vybráno │ 125 souborů │
|
||
|
|
└─────────────────────────────────────────────────────┘
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🎯 Použití
|
||
|
|
|
||
|
|
1. **Otevři složku** - Načti soubory ze složky (rekurzivně)
|
||
|
|
2. **Vytvoř tagy** - Hierarchická struktura (kategorie → tagy)
|
||
|
|
3. **Přiřaď tagy** - Označ soubory, vyber tagy
|
||
|
|
4. **Filtruj** - Klikni na tagy pro filtrování souborů
|
||
|
|
5. **Vyhledávej** - Textové vyhledávání v názvech
|
||
|
|
|
||
|
|
## ⌨️ Keyboard Shortcuts (moderní GUI)
|
||
|
|
|
||
|
|
- `Ctrl+O` - Otevřít složku
|
||
|
|
- `Ctrl+T` - Přiřadit tagy
|
||
|
|
- `Ctrl+D` - Nastavit datum
|
||
|
|
- `F5` - Refresh
|
||
|
|
- `Del` - Smazat z indexu
|
||
|
|
|
||
|
|
## 🏗️ Architektura
|
||
|
|
|
||
|
|
```
|
||
|
|
┌─────────────────────────────────┐
|
||
|
|
│ Presentation (UI) │ ← Tkinter GUI
|
||
|
|
├─────────────────────────────────┤
|
||
|
|
│ Business Logic │ ← FileManager, TagManager
|
||
|
|
├─────────────────────────────────┤
|
||
|
|
│ Data Layer │ ← File, Tag models
|
||
|
|
├─────────────────────────────────┤
|
||
|
|
│ Persistence │ ← JSON .!tag soubory
|
||
|
|
└─────────────────────────────────┘
|
||
|
|
```
|
||
|
|
|
||
|
|
## 📁 Struktura projektu
|
||
|
|
|
||
|
|
```
|
||
|
|
Tagger/
|
||
|
|
├── Tagger.py # Entry point (klasické GUI)
|
||
|
|
├── Tagger_modern.py # Entry point (moderní GUI)
|
||
|
|
├── PROJECT_NOTES.md # ⭐ Kompletní dokumentace
|
||
|
|
├── src/
|
||
|
|
│ ├── core/ # Business logika
|
||
|
|
│ │ ├── file.py
|
||
|
|
│ │ ├── tag.py
|
||
|
|
│ │ ├── file_manager.py
|
||
|
|
│ │ └── tag_manager.py
|
||
|
|
│ └── ui/
|
||
|
|
│ ├── gui.py # Klasické GUI
|
||
|
|
│ └── gui_modern.py # Moderní GUI
|
||
|
|
└── tests/ # 116 testů
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🧪 Testování
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Všechny testy (116 testů, 100% core coverage)
|
||
|
|
poetry run pytest tests/ -v
|
||
|
|
|
||
|
|
# S coverage report
|
||
|
|
poetry run pytest tests/ --cov=src/core --cov-report=html
|
||
|
|
```
|
||
|
|
|
||
|
|
## 📝 Dokumentace
|
||
|
|
|
||
|
|
**Veškerá dokumentace je v jednom souboru:**
|
||
|
|
|
||
|
|
👉 **[PROJECT_NOTES.md](PROJECT_NOTES.md)** ⭐
|
||
|
|
|
||
|
|
Obsahuje:
|
||
|
|
- Kompletní dokumentaci projektu
|
||
|
|
- Architektonická rozhodnutí (ADR)
|
||
|
|
- Coding standards
|
||
|
|
- Git workflow
|
||
|
|
- Known issues & TODO
|
||
|
|
- Debugování tipy
|
||
|
|
- Pravidla pro AI asistenty
|
||
|
|
|
||
|
|
## 🛠️ Technologie
|
||
|
|
|
||
|
|
- **Python:** 3.12
|
||
|
|
- **GUI:** Tkinter (standard library)
|
||
|
|
- **Dependencies:** Pillow (PIL)
|
||
|
|
- **Package manager:** Poetry
|
||
|
|
- **Testing:** pytest
|
||
|
|
|
||
|
|
## 📊 Metriky
|
||
|
|
|
||
|
|
- **Řádky kódu:** ~1060 Python LOC
|
||
|
|
- **Testy:** 116 (všechny ✅)
|
||
|
|
- **Test coverage:** 100% core modulů
|
||
|
|
- **GUI verze:** 2 (klasická + moderní)
|
||
|
|
|
||
|
|
## 🎯 Design Decisions
|
||
|
|
|
||
|
|
### Proč JSON místo databáze?
|
||
|
|
- ✅ Jednoduchý backup (copy složky)
|
||
|
|
- ✅ Git-friendly (plain text)
|
||
|
|
- ✅ Portable (žádné DB dependencies)
|
||
|
|
- ✅ Metadata zůstanou při přesunu souboru
|
||
|
|
|
||
|
|
### Proč Tkinter?
|
||
|
|
- ✅ Standard library (žádné extra deps)
|
||
|
|
- ✅ Cross-platform
|
||
|
|
- ✅ Dobře dokumentované
|
||
|
|
|
||
|
|
### Proč Poetry?
|
||
|
|
- ✅ Deterministické buildy (poetry.lock)
|
||
|
|
- ✅ Dev dependencies oddělené
|
||
|
|
- ✅ Moderní nástroj
|
||
|
|
|
||
|
|
## 🐛 Known Issues
|
||
|
|
|
||
|
|
- Git merge konflikty s poetry.lock při merge devel→feature
|
||
|
|
- Dlouhé operace (ffprobe) blokují UI - TODO: threading
|
||
|
|
|
||
|
|
## 🚀 Plánované features
|
||
|
|
|
||
|
|
- [ ] Progress bar pro dlouhé operace
|
||
|
|
- [ ] Undo/Redo mechanismus
|
||
|
|
- [ ] Export do CSV/Excel
|
||
|
|
- [ ] Dark mode theme
|
||
|
|
- [ ] Drag & drop souborů
|
||
|
|
|
||
|
|
## 📄 License
|
||
|
|
|
||
|
|
MIT License
|
||
|
|
|
||
|
|
## 👤 Autor
|
||
|
|
|
||
|
|
honza
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
**Pro detailní dokumentaci viz [PROJECT_NOTES.md](PROJECT_NOTES.md)**
|