Pièces Jointes

Les pièces jointes vous permettent d’envoyer des fichiers tels que des images, des journaux, des PDF et des artefacts en même temps que votre message. Leur arrivée sous forme de véritables pièces jointes dépend de ce que le service de destination prend en charge.

Pièces jointes via le CLI

Utilisez --attach une ou plusieurs fois :

apprise -t "Alerte système" -b "Voir le journal en pièce jointe" \
  --attach /var/log/syslog \
  "mailto://user:pass@example.com"

apprise -b "Voici les fichiers" \
  --attach /tmp/photo1.jpg \
  --attach /tmp/photo2.jpg \
  "tgram://..."

Pièces Jointes en Python

Passez un chemin unique ou une liste de chemins via attach :

from apprise import Apprise

apobj = Apprise()
apobj.add("tgram://...")

# Pièce jointe unique
apobj.notify(body="Voir la pièce jointe", attach="/path/to/file.txt")

# Plusieurs pièces jointes
apobj.notify(
    body="Artefacts joints",
    attach=[
        "/path/to/build.log",
        "/path/to/report.pdf",
    ],
)

Pièces Jointes Distantes (URLs)

Vous pouvez également fournir une URL et Apprise la récupérera avant la diffusion :

# Apprise téléchargera cette image et l'enverra à la destination
# si vous fournissez un couple user/pass, il s'authentifiera même
# avant de récupérer la pièce jointe
apobj.notify(
    body="Capture de la caméra de sécurité",
    attach="http://admin:pass@example.local/cam/snapshot.jpg"
)

Attention

Si l’URL d’une pièce jointe distante contient des identifiants, traitez-la comme un secret. Évitez de la versionner dans un dépôt ou de l’écrire dans les journaux.

Pièces Jointes en Mémoire (AttachMemory)

Lorsque vous générez du contenu à la volée — HTML rendu, graphiques, CSV, PDF — vous pouvez le transmettre directement sous forme d’objet AttachMemory sans écrire quoi que ce soit sur disque.

CSV (général)

Passez directement une chaîne ou des bytes — aucun fichier temporaire n’est créé :

import apprise
from apprise.attachment import AttachMemory

apobj = apprise.Apprise()
apobj.add("discord://webhook_id/webhook_token/")

apobj.notify(
    body="Les relevés du jour sont en pièce jointe.",
    attach=AttachMemory(
        content="date,value\n2026-03-20,42\n2026-03-21,38\n",
        name="readings.csv",
        mimetype="text/csv",
    ),
)

Le contenu str est automatiquement encodé en UTF-8. Utilisez bytes si vous disposez déjà de données binaires.

Pillow (image)

Générez une image avec Pillow et envoyez-la sans l’enregistrer sur disque :

import io
import apprise
from apprise.attachment import AttachMemory
from PIL import Image, ImageDraw

# Dessiner une image simple
img = Image.new("RGB", (400, 200), color=(30, 30, 30))
draw = ImageDraw.Draw(img)
draw.text((20, 80), "Bonjour depuis Apprise !", fill=(255, 255, 0))

# Rendre dans un tampon mémoire
buf = io.BytesIO()
img.save(buf, format="PNG")

apobj = apprise.Apprise()
apobj.add("tgram://bottoken/ChatID")

apobj.notify(
    body="Image générée en pièce jointe.",
    attach=AttachMemory(
        content=buf.getvalue(),
        name="hello.png",
        mimetype="image/png",
    ),
)

Matplotlib (graphique)

Générez un graphique avec Matplotlib et joignez-le directement :

import io
import apprise
from apprise.attachment import AttachMemory
import matplotlib.pyplot as plt

# Construire le graphique
fig, ax = plt.subplots()
ax.plot([1, 2, 3, 4], [10, 24, 18, 32])
ax.set_title("Mesure quotidienne")
ax.set_xlabel("Jour")
ax.set_ylabel("Valeur")

# Rendre dans un tampon mémoire
buf = io.BytesIO()
fig.savefig(buf, format="png")
plt.close(fig)

apobj = apprise.Apprise()
apobj.add("tgram://bottoken/ChatID")

apobj.notify(
    body="Graphique de tendance nocturne en pièce jointe.",
    attach=AttachMemory(
        content=buf.getvalue(),
        name="trend.png",
        mimetype="image/png",
    ),
)

Astuce

Pour tous les détails sur les trois types de pièces jointes (AttachFile, AttachHTTP, AttachMemory) ainsi que les recommandations pour les auteurs de plugins, consultez la référence sur les pièces jointes.