LAlex devblog v6 - Parseur ActionScript2 en PHP : premier essai - Commentaires

Parseur ActionScript2 en PHP : premier essai - chris

chris — Fri, 09 Dec 2005 21:58:21 +0000

mon dieu que c'est compliqué. ca me fait tres envi mais je n'arrive pas appliquer pour mes propres projets c'est contrariant

Parseur ActionScript2 en PHP : premier essai - Lorenzo

Lorenzo — Sun, 10 Jul 2005 01:55:52 +0000

J'ai déja fait et fini un parseur AS2, il fonctionne avec un BD MySQL.

si tu as des questions, tu as mon icq : 49165571 (impossible de mettre mon email : email non valide ???)

oui, les regexp sont les + compliqués a faire, surtout pour les propriétés + méthodes s'écrivant pareil pour des classes différentes ...

j'utilise un systeme en 2 passes :
1-reconnaissance et remplacement du code par des balises
2-remplacement des balises par l'HTML pour colorier et/ou lier le code

pour le 1 :
-commence par virer tout ce qui est commentaire
-en 2eme, toutes les chaines (attention ou ' inclus dans ") ...

Parseur ActionScript2 en PHP : premier essai - LAlex

LAlex — Fri, 19 Dec 2003 17:41:11 +0000

nicolas >> Le format reste à définir, et pour être franc, je ne pense pas m'en occuper ! :°

Si le moment venu je trouve quelqu'un qui veut me filer un coup de main la dessus, ce sera à lui de définir le format ...

Parseur ActionScript2 en PHP : premier essai - nicolas

nicolas — Fri, 19 Dec 2003 15:17:54 +0000

Pense à commenter facon PHPdoc

Parseur ActionScript2 en PHP : premier essai - Kalysto

Kalysto — Wed, 17 Dec 2003 13:57:44 +0000

un bon point pour l'open source on se sent obliger de documenter son code
lol

Parseur ActionScript2 en PHP : premier essai - LAlex

LAlex — Mon, 15 Dec 2003 16:08:21 +0000

C une mauvaise habitu de ke g du mal a perdre le "mais si! je vais commenter a la fin!"C'est vrai ! Mais c'est pas évident d'aller contre ... Moi maintenant, je publie mes codes, comme ca je me sens obligé de les commenter !!!

Parseur ActionScript2 en PHP : premier essai - Kalysto

Kalysto — Mon, 15 Dec 2003 15:17:12 +0000

ben on a ka mettre Object comme ca c generique

C une mauvaise habitu de ke g du mal a perdre le "mais si! je vais commenter a la fin!"

Parseur ActionScript2 en PHP : premier essai - LAlex

LAlex — Mon, 15 Dec 2003 14:35:14 +0000

Ben, mon parseur gère aussi les signatures sans typage fort ... aprés il faut voir si on accepte de l'intégrer dans le JavaDoc s'il n'y est pas ... 8|

Quand à "l'aide au commentaire", personnellement, tant que le code n'est pas trop immense, je préfère commenter à la fin (si je suis tout seul à coder évidemment), et ce genre de petit outil peut être sympa ...

Parseur ActionScript2 en PHP : premier essai - Kalysto

Kalysto — Mon, 15 Dec 2003 14:11:22 +0000

dans les IDE classiques, la saisie de la javadoc est prise en charge par des wizards ... mais c'est pendant le codage, pas pendant le parsage du fichier kil faut le faire ...
Enfin c'est un autre outil

le /** indique le debut d'un commentaire javadoc, il ne peut yen avoir que devant les fields, methodes et classes (et interfaces :)) : les /** a l'interieur d'une fonction n'est pas pris en compte!

Ben, javadoc s'appuie aussi sur les signatures des methodes pour en retirer les informations de types et de retour. Normal, les infos y sont dejas, pourkio les reecrire dans la doc ?

Par contre, ca necessite du code bien fait pour ke ca fonctionne ! Les gens ki oublieront le typage fort vont l'avoir dans l'os

Parseur ActionScript2 en PHP : premier essai - LAlex

LAlex — Mon, 15 Dec 2003 14:02:49 +0000

Oui, même si je ne l'utilise pas, la réputation de JavaDoc n'est plus à faire !

Par contre, du coup, ce ne serait pas incompatible avec une génération des commentaires par rapport aux signatures du code ... pour permettre une saisie plus facile pour les gens qui n'ont pas forcément l'habitude de commenter leur code d'un manière bien précise (comme moi :oops:) : un outil qui interviendrait avant pourrait leur proposer des zones de saisie à remplir ... 8|

Pour avoir un peu plus d'infos sur le "format" JavaDoc, le /** (avec deux étoiles) fait partie du standard ? :o Et dans ta classe exemple, je ne vois pas d'infos sur les types du retour et des arguments, c'est normal ? :o

A+

Parseur ActionScript2 en PHP : premier essai - Kalysto

Kalysto — Mon, 15 Dec 2003 13:49:38 +0000

de toute facon, on ne peut pas creer la doc a la place de l'utilisateur, on peut juste la mettre en forme.

Ya juste a se mettre d'accord sur un format de doc. moi je preconise javadoc paske ca me semble pratik et bien concu de base ...

Parseur ActionScript2 en PHP : premier essai - Kalysto

Kalysto — Mon, 15 Dec 2003 13:21:33 +0000

Ben il recoit un fichier XML qui represente une classe AS, avec les commentaires recuperable.

Apres, on peut parser le commentaire pour en sortir :
- la documentation
- les params
- les exceptions thrown
- les todo
- bref tous les tags (@qqch) qu'on veut

Apres, ca nous fait un autre fichier xml qui n'incorpore que les infos dont on a besoins (commentaires + signatures)

on cree une feuille de style XSLT et pouf, on gagne une page web toute bien formatée qui est une sorte de javadoc.

Bref le principe c :
.as - php parser -> xml - comment parser -> xml(avec les commentaires) - XSLT -> HTML

Parseur ActionScript2 en PHP : premier essai - LAlex

LAlex — Mon, 15 Dec 2003 12:15:29 +0000

Oui, ce parser pourrait tout à fait générer du XML. Pour l'instant, il ressort un arborescence de tableaux associatifs : il suffit de remplacer ca par des balises XML !

Sinon, comment pourrait fonctionner ton générateur de FlashDoc ? :o Moi, je pensais deja récupérer les signatures des méthodes, et en faire des commentaires justement ... 8| Toi tu veux te baser sur les commentaires deja présents ? :o

Il va falloir qu'on cause de ca un peu !

Parseur ActionScript2 en PHP : premier essai - Kalysto

Kalysto — Mon, 15 Dec 2003 11:55:57 +0000

Ca serait comme FlashDoc mais en OpenSource et donc gratuit
Tout ce qu'il faut faire c choper les commentaires avant la classe et devant tous les membres (public).

ex :
/** * Une classe Comment sert a voir si les commentaires style javadoc fonctionnenent * @author Kalysto * @see net.toytoy.CommentTwo * @version 1.0 * @since 0.2 */ class net.toytoy.Comment { /** The comment's message */ public var msg:String; /** jolie constante non ? */ public static var CONSTANT:Number = 42; /** * Create a new Instance of Comment * @param m the comment message */ public Comment(m:String) { msg = m; } /** * create a Comment * @param m the comment message * @return the Comment instance */ public static function createComment(m:String):Comment { return new Comment(m); } }

Parseur ActionScript2 en PHP : premier essai - Kalysto

Kalysto — Mon, 15 Dec 2003 10:45:27 +0000

la question reste pour la grammaire AS 2.0 ... des idees/suggestions ?

Merci

Parseur ActionScript2 en PHP : premier essai - Kalysto

Kalysto — Mon, 15 Dec 2003 10:31:18 +0000

oui source forge c pour le travail collaboratif dans des teams...

ton parser, il pourrait pas sortir du XML ? si tu peux faire ca, moi je te ponds un chtit truc qui te genere une sorte de javadoc en fonction des commentaires mis dans le code ...

Parseur ActionScript2 en PHP : premier essai - LAlex

LAlex — Mon, 15 Dec 2003 10:20:15 +0000

Euh ... un autre sourceforge, pas vraiment ... :roll: C'était juste une image pour donner une vague idée de ce que ca pourrait être ...

En fait, de ce que j'en sais (car je ne l'ai jamais utilisé), Sourceforge apporte aux équipes de développement tous les outils pour un travail collaboratif. Moi je veux fournir un outil qui permet de soumettre un code sans forcément faire partie d'un team dejà montée. Ou de proposer une implémentation de certaines fonctionnalités, tout en permettant à chacun de proposer une meilleure implémentation : plus logique ou plus optimisée ...

Si ensuite, je peux y gréffer un système de teams, pourquoi pas ? Mais je veux faire un outil propre à AS2, qui puisse récupérer un cetain nombre d'informations d'une classe, et en déduire les dépendances, et ce afin de garder une certaine cohérence dans les interférences entre différentes classes ... :o

Parseur ActionScript2 en PHP : premier essai - Kalysto

Kalysto — Mon, 15 Dec 2003 10:02:07 +0000

Quelqu'un sait il ou trouver une grammaire du langage AS 2.0 ?
Pasqu'il existe des parser de grammaire qui te generent des sources pour pouvoir parser simplement un fichier source.

a ce que g compris, a terme tu voudrais faire un autre sourceforge ?
pourquoi reinventer la roue ? il existe deja des projets pour faire ca (avec bug tracking et tout) ce qui permet de se concentrer sur les projets (ou le code) que tu veux fournir.

Parseur ActionScript2 en PHP : premier essai - qwix

qwix — Sat, 13 Dec 2003 13:22:56 +0000

Essaies de détecter le " " ainsi pour pourra voir si un commentaire "//" et sur une ligne ou pas

Parseur ActionScript2 en PHP : premier essai - LAlex

LAlex — Sat, 13 Dec 2003 12:43:49 +0000

Le problème des antislashs est réglé ! Il me reste celui des commentaires sur le même ligne qu'une ligne de code ...