Da pyCoinCoin Plug-ins Base

iiiiiciiii

Liste des plug-ins disponibles pour pyCoinCoin
Liste des Bots fournis avec pyCoinCoin
Mini-faq sur les plug-ins

Plug-ins disponibles

Liste des plug-ins intégrés dans la version 0.6

Plug-ins palmipède

Fichier stringutils.py :

coin_trevni : permet d'inverser du texte (srevne'l à erutircé)
coin_UPPERCASE : pour mettre du texte EN MAJUSCULES
coin_lowercase : devinez...
coin_mIxEdcASe : bon, vOuS avEz cOmpRiS. Remarque : la majusculisation est aléatoire (chaque lettre a une chance sur 2 d'être en majuscule).
coin_CapitalizeWords :Voilà Le Résultat De L'Application De Cette Fonction.
coin_wikifier : pour passer le [Texte] [En] [Style] [Wiki].

Fichier cowboyz.py :

coin_cOwbOyz : permet de transformer du texte en 3cRi7|_|®e |)3 \/\/4rL0rD2. Dans le fichier, vous pouvez enrichir / éditer à votre convenance le dictionnaire "cowboyz_map" qui contient les chaînes de remplacement des caractères "normaux"

Fichier pika.py :

coin_pikachize : transforme le texte en langage Pikachu grâce au Pikachizer

Fichier pdfm.py :

coin_PlateauDeFruitsDeMer : eh oui, comme son nom l'indique, il s'agit bien d'un plug-in qui permet de sauvegarder tout le contenu du pinnipède dans un fichier html. Pour profiter de ce plug-in, il faut l'associer à une combinaison de touches (voir Da Palmipède HotKeys Editor) - ensuite, le Plateau de Fruits de Mer pourra être invoqué par cette combinaison depuis le Palmipède editor.

Fichier mozm.py :

coin_ElectionsMOZM : ce plug-in permet de comptabiliser des votes lors d'une session d'élections pour Ze (Moule|Boulay|...) Of Ze Monf. Il génère une page html.
Voici son fonctionnement : premièrement, on saisit un titre pour l'élection, puis on entre l'heure de départ et l'heure de fin des votes. Le plug-in parcourt alors tous les votes du pinnipède et recense les votes entre ces 2 heures incluses.
Les votes valides remplissent les conditions suivantes :

Le posteur doit être authentifié
Le post doit être en gras
Le post-vote ne doit comporter que 3 mots : login vote moule
En cas de votes multiples, seul le premier vote valide est pris en compte

Plug-ins pinnipède

Fichier plop.py :

coin_plopify : un plopificateur. Dans le fichier, vous pouvez régler à votre convenance les paramètres suivants :

plop_words : la liste des mots-plop
plop_density : le pourcentage de mots qui seront remplacés par des mots-plop dans le message
plop_exclude : expression régulière désignant des mots qui ne doivent pas être ploppés (utile si on ne veut pas plopper les horloges-références, les urls... par exemple)

Fichier pikaplop.py :

coin_pikachize : une variante du plopificateur : transforme le texte d'un message en langage Pikachu, gràce au Pikachizer
coin_boitakon : émulateur de boitakon. Le post est totalement effacé, seule une ligne vide apparaît dans le pinnipède.

Les Bots fournis par défaut avec la version 0.6

Mes Posts

Ce bot colorise vos posts. Avant de le lancer, vous devez l'adapter : mettez votre login linuxfr (ou le pseudo que vous utilisez sur la tribune quand vous postez authentifié) dans le champ "regexp", à la place de "mon_login". Vous pouvez aussi effectuer la recherche sur le User Agent si vous postez en anonyme.

Bigornophone

Ce bot permet d'effectuer une action quand quelqu'un cherche à vous appeler sur la tribune. Avant de le lancer, remplacez "mon_login" par votre pseudo de tribune dans le champ "regexp". Vous pouvez aussi personnaliser l'action (par défaut, c'est un simple message dans la console).

Copains

Ce bot vous permet de mieux repérer les posts de certaines personnes dans la tribune. Mettre simplement les pseudos de vos amis à la place des "copainN dans la regexp.

Plopifier

Est-il besoin de présenter la célèbre fonction de plopification originellement introduite dans wmCoinCoin ? :-) Pour plopifier un boulay, remplacez "le_boulay" par le login de la personne à plopifier. Pour plopifier plusieurs personnes, on pourra mettre boulay1|boulay2|... - penser aussi à la possibilité de plopifier par mot-clé, en effectuant la recherche sur le message plutôt que sur le login du posteur. Attention, limitation : la plopification est irréversible... Ok, ok, ça sux :-)
Ce bot pourra servir de modèle pour des bots similaires : pikachizeur, boitakonifieur, etc.

DaPyc²PlopBot

D'une utilité qui n'est plus à démontrer ;-)

Mini-faq

Qu'est-ce qu'un plug-in au sens pyCoinCoin ?

C'est une fonction Python qui peut être invoquée soit depuis le Palmipède, via raccourci clavier, soit par un Bot.

Qu'est-ce que ça fait ?

Virtuellement, on peut tout faire avec un plug-in. Dans la pratique, il y a 2 catégories de plug-ins ayant chacun des applications spécifiques : les plug-ins pour le Palmipède, et les plug-ins pour le Pinnipède.

Mais encore ?

Les plug-ins pour le Palmipède pourront être utilisés pour transformer le texte qu'on est en train d'éditer (par exemple : c0wb0yZ tr4n5lat0R, etc.)
Les plug-ins pour le Pinnipède sont destinés à être utilisés par des Bots à action immédiate, afin de faire subir des transformations à un post avant que celui-ci soit affiché dans le Pinnipède. Typiquement, un plopificateur par exemple :)
En plus de ces 2 cas "standard", il n'est pas exclu qu'un plug-in ait des "effets de bord", ce qui étend les possibilités considérablement... exemple : plateau de fruits de mer, etc.

Comment cela se programme-t-il ?

On écrit des fonctions respectant un certain profil dans de beaux fichiers .py, et on place ces fichiers dans des répertoires spéciaux :

plugins/palmi/ pour les plug-ins Palmipède,
plugins/pinni/ pour les plug-ins Pinnipède.

Et ce fameux "certain profil"...?

Pour les plug-ins Palmipède :
def coin_mafonction(chaine, trib) [votre code] return monresultat
La variable retournée monresultat doit être une chaîne.
Pour les plug-ins Pinnipède :
def coin_mafonction(post, trib) [votre code] return monpost
La variable retournée monpost doit être de type Post. Voir la définition de cet objet dans le fichier Post.py.

Le préfixe "coin_" est important, il permet à pyCoinCoin de distinguer les fonctions qui sont effectivement des plug-ins des autres que l'on peut éventuellement définir selon ses besoins.
Le second paramètre des fonctions-plug-ins "trib" est de type Tribune. Il permet, en gros, d'accéder à tous les objets de pyCoinCoin. Je réponds tout de suite à votre question, oui, on peut donc tout casser !! Je conseille, pour le moment, d'en réserver l'usage aux pythonneurs chevronnés qui auront le courage de lire tout le code de pyCoinCoin, parce que là, j'ai trop la flemme de faire une doc dessus ! Ceci dit, consultez les exemples de plug-ins fournis, notemment le plateau de fruits de mer et Elections MOZM, vous verrez comment accéder à la liste des posts stockés dans le pinnipède...

Da pyCoinCoin User Guide | Retour à la heaume page