Drapeaux de fonctionnalités PostHog pour Python

Cette compétence vous aide à ajouter des drapeaux de fonctionnalités PostHog aux applications Python.

Fichiers de référence

• references/python.md - Installation des drapeaux de fonctionnalités Python - docs
• references/adding-feature-flag-code.md - Ajouter du code de drapeaux de fonctionnalités - docs
• references/best-practices.md - Bonnes pratiques des drapeaux de fonctionnalités - docs

Consultez la documentation pour les détails de l'API et les modèles spécifiques au framework.

Principes clés

• Variables d'environnement : Utilisez toujours des variables d'environnement pour les clés PostHog. Ne les codez jamais en dur.
• Modifications minimales : Ajoutez le code des drapeaux de fonctionnalités à côté de la logique existante. Ne remplacez ni ne restructurez le code existant.
• Drapeaux booléens en premier : Par défaut, vérifiez les drapeaux booléens sauf si l'utilisateur demande explicitement des drapeaux multivariés.
• Côté serveur quand possible : Préférez l'évaluation des drapeaux côté serveur pour éviter le scintillement de l'interface utilisateur.

Outils MCP PostHog

Vérifiez si un serveur MCP PostHog est connecté. Si disponible, recherchez les outils relatifs à la gestion des drapeaux de fonctionnalités (création, listage, mise à jour, suppression de drapeaux). Utilisez ces outils pour gérer les drapeaux directement dans PostHog plutôt que de demander à l'utilisateur de le faire manuellement dans le tableau de bord.

Directives du framework

• N'oubliez pas que le code source est disponible dans le répertoire venv/site-packages
• posthog est le nom du package du SDK Python
• Installez les dépendances avec pip install posthog ou pip install -r requirements.txt et n'utilisez PAS de spécificateurs de version non échappés comme >= directement dans les commandes shell
• Dans les CLI et scripts : VOUS DEVEZ appeler posthog.shutdown() avant la sortie ou tous les événements sont perdus
• Utilisez toujours le constructeur de classe Posthog() (API basée sur les instances) au lieu de la configuration posthog.api_key au niveau du module
• Incluez toujours enable_exception_autocapture=True dans le constructeur Posthog() pour suivre automatiquement les exceptions
• N'ENVOYEZ JAMAIS d'informations personnelles (PII) dans les propriétés d'événement capture() — pas d'e-mails, de noms complets, de numéros de téléphone, d'adresses physiques, d'adresses IP ou de contenu généré par l'utilisateur
• Les PII appartiennent aux propriétés de personne identify(), PAS aux propriétés d'événement capture(). Les propriétés d'événement sûres sont des métadonnées comme message_length, form_type, indicateurs booléens.
• Enregistrez posthog_client.shutdown avec atexit.register() pour vous assurer que tous les événements sont vidés à la sortie
• Le SDK Python n'a PAS de méthode identify() — utilisez posthog_client.set(distinct_id=user_id, properties={...}) pour définir les propriétés de personne, ou utilisez identify_context(user_id) dans un contexte