🐍 BSPy — moteur Python

Introduction

moteur Python est le API Python de BotStrike. Il permet de créer des bots Telegram en Python avec une architecture simple :

• Chaque commande dans un fichier .py séparé (start.py, help.py…)
• Zéro import — bot, Api, Props sont injectés automatiquement
• Info utilisateur dans le dict u (prête à l'emploi)

Structure des fichiers

Chaque commande est un fichier .py dans le dossier commands/. Le API moteur Python charge automatiquement tous les fichiers.

Variables globales (dans chaque .py)

Contenu du dict u :

Envoi de messages

Bot.sendMessage(text)

Envoie un message texte au chat actuel (chat_id automatique). Formatage HTML activé.

Copier# start.py — Commande /start
Bot.sendMessage(f"Bienvenue <b>{u['nom']}</b> ! 👋")

Suppression automatique (delete_after)

Passez un objet en second paramètre avec delete_after pour supprimer le message après N secondes :

Copier# Le message disparaît après 5 secondes
Bot.sendMessage("Ce message va disparaître... 👻", {"delete_after": 5})

Options d'envoi

Toutes les méthodes d'envoi acceptent un objet d'options :

Copier# Exemple combiné
Bot.sendMessage("📌 Annonce", {"pin": True, "silent": True})

Bot.sendButtons(text, buttons)

Envoie un clavier inline. Chaque bouton a text + data (callback) ou url.

CopierBot.sendButtons("Choisissez une option :", [
    {"text": "📦 Catalogue", "data": "catalogue"},
    {"text": "📞 Contact", "data": "contact"},
    {"text": "🔗 Site web", "url": "https://exemple.com"},
])

Bot.sendMenu(text, options)

Envoie un reply keyboard (menu persistant en bas de l'écran).

CopierBot.sendMenu("Menu principal :", [
    ["📊 Stats", "⚙️ Paramètres"],
    ["❓ Aide"]
])

Photos, Vidéos, Documents

CopierBot.sendPhoto("https://exemple.com/produit.jpg", "<b>Notre produit</b>")

Actions

Bot.action(type, wait, next)

Affiche un indicateur (typing…), attend X secondes, puis exécute automatiquement une commande. Le chat_id est automatique.

Copier# Afficher "en train d'écrire…" pendant 2 sec puis lancer /contact
Bot.action(type="typing", wait=2, next="/contact")

Exécuter une autre commande (runCommand)

Utilisez Bot.action(next="/commande") pour chaîner l'exécution vers une autre commande :

Copier# Rediriger vers /catalogue après 1 seconde
Bot.action(wait=1, next="/catalogue")

# Exécuter immédiatement /help
Bot.action(next="/help")

Requêtes HTTP

Appelez des APIs externes directement depuis vos commandes. Utilisez le proxy HTTP (recommandé) ou bot.http_get().

Copier# GET — récupérer des données
data = HTTP.get("https://api.exemple.com/users", token="mon_token_api")
Bot.sendMessage(f"Résultat : {data}")

Copier# POST — envoyer des données
result = HTTP.post("https://api.exemple.com/order", body={"product": "A1", "qty": 2})
Bot.sendMessage(f"Commande : {result}")

Stockage (Props)

Stockez des données persistantes par bot. Limite : 500 KB.

Copier# Enregistrer le solde d'un utilisateur
Props.set(f"balance_{u['id']}", 100)

# Le récupérer
balance = Props.get(f"balance_{u['id']}")
Bot.sendMessage(f"💰 Solde : {balance}")

# Vérifier l'espace utilisé
info = Props.storage()
Bot.sendMessage(f"Utilisé : {info['used']} KB / restant : {info['remaining']} KB")

Commandes

Chaque commande est un fichier .py dans le dossier commands/. Le nom du fichier = le nom de la commande.

Commande Master (*)

Le fichier _.py (underscore) capture tous les messages qui ne correspondent à aucune commande enregistrée.

Copier# _.py — commande master (capture tout)
Bot.sendMessage(f"Vous avez dit : {message}")

Callbacks (boutons inline)

Quand un utilisateur clique sur un bouton inline avec data, le callback correspondant est déclenché.

Copier# Enregistrer un callback
Bot.registerCallback("catalogue", ma_fonction)

Api — Appels Telegram directs

L'objet Api permet d'appeler n'importe quelle méthode de l'API Bot Telegram directement, sans limitation.

Copier# Envoyer un message avec options avancées
Api.sendMessage({
    "chat_id": chat_id,
    "text": "<b>Message formaté</b>",
    "parse_mode": "HTML",
    "disable_notification": True
})

Api.sendPhoto

Copier# Envoyer une photo avec légende
Api.sendPhoto({
    "chat_id": chat_id,
    "photo": "https://exemple.com/img.jpg",
    "caption": "<b>Légende en HTML</b>",
    "parse_mode": "HTML"
})

Api.sendVideo

Copier# Envoyer une vidéo
Api.sendVideo({
    "chat_id": chat_id,
    "video": "https://exemple.com/video.mp4",
    "caption": "Ma vidéo",
    "parse_mode": "HTML"
})

Api.sendDocument

Copier# Envoyer un document / fichier
Api.sendDocument({
    "chat_id": chat_id,
    "document": "https://exemple.com/fichier.pdf",
    "caption": "Votre fichier 📎",
    "parse_mode": "HTML"
})

Api.editMessageText

Copier# Modifier un message existant
Api.editMessageText({
    "chat_id": chat_id,
    "message_id": u["message_id"],
    "text": "Texte mis à jour ✅"
})

Api.deleteMessage

Copier# Supprimer un message
Api.deleteMessage({
    "chat_id": chat_id,
    "message_id": u["message_id"]
})