portfolio-django/projects/utils.py

"""
Utilitaires pour charger et manipuler les données projets depuis le JSON.
Modifier uniquement data/projects.json pour mettre à jour le portfolio.
"""

import json
import re
from pathlib import Path
from typing import Optional, List, Dict
from django.conf import settings


def load_config() -> Dict:
    """
    Charge la configuration globale du site depuis data/config.json.
    Contient : profil, navbar, compétences, expériences, contact, footer, SEO.
    Pour modifier les infos du site, éditez uniquement data/config.json.
    """
    config_path: Path = settings.CONFIG_JSON_PATH

    if not config_path.exists():
        return {}

    with open(config_path, 'r', encoding='utf-8') as f:
        return json.load(f)


def load_projects() -> List[Dict]:
    """
    Charge tous les projets depuis le fichier JSON.
    Retourne une liste de dictionnaires projets.
    """
    json_path: Path = settings.PROJECTS_JSON_PATH

    if not json_path.exists():
        return []

    with open(json_path, 'r', encoding='utf-8') as f:
        data = json.load(f)

    projects = data.get('projects', [])

    # Générer un slug unique pour chaque projet (utilisé dans les URLs)
    for i, project in enumerate(projects):
        project['slug'] = _slugify(project.get('title', f'projet-{i}'))
        project['id'] = i  # Index pour retrouver le projet facilement

    return projects


def get_project_by_slug(slug: str) -> Optional[Dict]:
    """
    Retourne un projet spécifique par son slug.
    """
    projects = load_projects()
    for project in projects:
        if project.get('slug') == slug:
            return project
    return None


def get_all_categories(projects: List[Dict]) -> List[str]:
    """
    Retourne la liste unique de toutes les catégories disponibles.
    """
    categories = set()
    for project in projects:
        cat = project.get('category', '').strip()
        if cat:
            categories.add(cat)
    return sorted(list(categories))


def get_all_technologies(projects: List[Dict]) -> List[str]:
    """
    Retourne la liste unique de toutes les technologies utilisées,
    triées par fréquence décroissante (les plus utilisées en premier).
    """
    freq: Dict[str, int] = {}
    for project in projects:
        for tech in project.get('technologies', []):
            t = tech.strip()
            freq[t] = freq.get(t, 0) + 1
    return sorted(freq.keys(), key=lambda t: (-freq[t], t))


def filter_projects(projects: List[Dict], category: str = '', tech: str = '') -> List[Dict]:
    """
    Filtre les projets par catégorie et/ou technologie.
    """
    filtered = projects

    if category:
        filtered = [p for p in filtered if p.get('category', '').lower() == category.lower()]

    if tech:
        filtered = [
            p for p in filtered
            if any(t.lower() == tech.lower() for t in p.get('technologies', []))
        ]

    return filtered


def _slugify(text: str) -> str:
    """
    Convertit un titre en slug URL-safe.
    Ex: "Mon Super Projet" → "mon-super-projet"
    """
    text = text.lower().strip()
    # Remplacer les caractères accentués
    replacements = {
        'à': 'a', 'â': 'a', 'ä': 'a',
        'é': 'e', 'è': 'e', 'ê': 'e', 'ë': 'e',
        'î': 'i', 'ï': 'i',
        'ô': 'o', 'ö': 'o',
        'ù': 'u', 'û': 'u', 'ü': 'u',
        'ç': 'c', 'ñ': 'n',
    }
    for char, replacement in replacements.items():
        text = text.replace(char, replacement)
    # Remplacer tout caractère non alphanumérique par un tiret
    text = re.sub(r'[^a-z0-9]+', '-', text)
    text = text.strip('-')
    return text