Python Project Finder

Aplikace pro vyhledávání a správu Python projektů na disku s moderním grafickým rozhraním postavená na PySide6.

Funkce aplikace

• Vyhledávání Python projektů v zadaném adresáři a jeho podsložkách
• Zobrazení detailních informací o nalezených projektech (cesta, počet souborů, velikost, poslední změna)
• Identifikace potenciálně duplicitních projektů na základě podobnosti souborů
• Export a import seznamu projektů do/z JSON souboru
• Konfigurace ignorovaných adresářů a přípon souborů
• Přehledné grafické rozhraní s možností filtrování a řazení projektů
• Intuitivní nastavení parametrů vyhledávání přes dialogové okno

Instalace

1. Naklonujte repozitář:

git clone https://github.com/mastnacek/python-project-finder.git
cd python-project-finder

2. Vytvořte a aktivujte virtuální prostředí:

# Windows
python -m venv venv
venv\Scripts\activate

# Linux/Mac
python -m venv venv
source venv/bin/activate

3. Nainstalujte požadované závislosti:

pip install -r requirements.txt

Spuštění aplikace

python main.py

Požadavky

• Python 3.6+
• PySide6 >= 6.4.0

Struktura projektu

/
├── config.py                # Konfigurační konstanty
├── main.py                  # Vstupní bod aplikace
├── model/
│   ├── __init__.py
│   ├── project_model.py     # Datový model projektu
│   └── finder_model.py      # Logika vyhledávání projektů
├── view/
│   ├── __init__.py
│   ├── main_window.py       # Hlavní okno aplikace
│   ├── project_list_view.py # Seznam nalezených projektů
│   ├── settings_dialog.py   # Dialog nastavení
│   └── help_dialog.py       # Dialog nápovědy
├── controller/
│   ├── __init__.py
│   ├── app_controller.py    # Hlavní controller aplikace
│   └── finder_controller.py # Controller pro vyhledávání
├── resources/
│   ├── icons/               # Ikony aplikace
│   └── style/               # CSS styly
└── utils/
    ├── __init__.py
    └── json_handler.py      # Práce s JSON soubory

Architektura

Aplikace je postavena na architektonickém vzoru MVC (Model-View-Controller):

• Model - Obsahuje datovou strukturu a logiku pro vyhledávání a správu projektů
• View - Definuje uživatelské rozhraní a způsob prezentace dat
• Controller - Řídí tok aplikace a propojuje Model a View

Licence

Tento projekt je licencován pod MIT licencí - podrobnosti viz soubor LICENSE.

Autor

mastnacek