Menu

Guide de démarrage utilisateur

Lionel EA Quentin Piot

Introduction

Cette application est un outil en ligne de commande permettant d'extraire et d'analyser le contenu de boîte mails.
Cet outil est doté de fonctionnalités telle que :

  • Analyse de fichiers conforme à la norme Internet Message Format RFC 5322
  • Formattage et affichage de mails
  • Filtrage de mails
  • Génération de fichiers vCard (RFC 6350) à partir de mails
  • Création de graphiques au format SVG afin de visualiser certaines statistiques
  • Visualisation des interactions entre les différents collaborateurs.

Démarrage rapide

Commencez par cloner le dépôt SourceForge en entrant dans un terminal la commande suivante :

svn checkout svn://svn.code.sf.net/p/quarotte-gl02/code/ quarotte

Veillez à bien avoir installé NodeJS sur votre machine.

Placez vous dans le repertoire quarotte/trunk/ qui vient d'être crée et installez toutes les dépendances du logiciel en utilisant

npm install

Et voilà ! Vous pouvez désormais commencer à utiliser l'application en lançant avec node le fichier quarotte/trunk/index.js en faisant

node index.js

Sous MacOS ou Linux vous pouvez créer un alias vers l'application en ajoutant au fichier de configuration .bashrc la ligne suivante, en modifiant le chemin vers le dépot local.

alias quarotte="node <chemin vers le dépôt local>/quarotte/trunk/index.js"

Par la suite de ce guide, utilisera la commande quarotte pour utiliser l'outil (avec l'alias définit précedemment)

Utilisation

quarotte <commande> [options]

Afin de commencer à utiliser les différentes fonctionnalités, il vous faut un jeu de donnée manipulable et compatible avec l'outil. Un exemple de données est contenu dans le repertoire quarotte/trunk/data/. Les mails sont formattés suivant RFC 5322.
Exemple de mail :

:::text
Message-ID: <25126788.1075851912175.JavaMail.evans@thyme>
Date: Tue, 24 Aug 1999 03:47:00 -0700 (PDT)
From: louis.soldano@enron.com
To: leo.nichols@enron.com, larry.campbell@enron.com
Subject: PCBs - charcterizations program
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
X-From: Louis Soldano
X-To: Leo Nichols, Larry Campbell
X-cc: 
X-bcc: 
X-Folder: \Larry_Campbell_Nov2001_1\Notes Folders\Pcb's
X-Origin: CAMPBELL-L
X-FileName: lcampbe.nsf

gents - first in a series of "i owe you" materails.   i've not forgotten and 
we will have a close fo final draft by end of month...

i'll try to send more materials over the next couple of days..


larry - i'll probbaly drag terrsaso out with me towards the 
salut

Le programme est présenté de la manière suivante :

Exemple d'utilisation d'une commande

Nous utiliserons la commande pour générer un graphique à partir des collaborateurs contactés par un collaborateur donné.
Pour une utilisation Node.JS, on a la commande suivante :

node index.js plot "./donneesSujetB/arnold-j" "John Arnold" graph
  • plot : la commande utilisée
  • "./donneesSujetB/arnold-j" : le dossier dans lequel sont situés des mails ou des dossiers contenant des mails
  • "John Arnold" : le nom complet de l'utilisateur
  • graph : le nom du fichier qui sera fournit au format svg

On obtient donc en sortie graph.svg

Pour obtenir d'autres informations sur les autres commandes vous pouvez utilisez la commande suivante :

node index.js readme

Pour obtenir d'autres informations sur une commande précise, vous pouvez utilisez l'options -h ou -help:

node index.js plot -h


MongoDB Logo MongoDB