Newbiecontest FileSystem
========================

Packages nécessaires
--------------------
fuse
python-fuse
python-request
lxml

Optionels:
python-html2text

Utilisation
-----------
Lancer avec :
$ mkdir newbiecontest
$ ./newbiecontest-fuse.py newbiecontest

Et explorer le répertoire 'newbiecontest'.

Pour avoir la liste complète des options de fuse :
./newbiecontest-fuse.py --help

Pour arrêter :
fusermount -u newbiecontest

Fichiers
--------
 * /username et /password
	Les fichiers username et password peuvent être écrits pour indiquer les
	informations d'authentification pour le site.

 * /deauth
	Si une valeur numérique différente de 0 est écrite dans le fichier
	deauth, l'utilisateur sera déconnecté du site.

 * /news/*
	Contient les news en page d'accueil du site. Si le module python
	html2text est disponible, un rendu HTML basique est disponible.

 * /challenges
	Contient un répertoire par catégorie de challenge.

 * /challenges/<categorie>
	Contient un répertoire par challenge.

 * /challenges/<categorie>/<challenge>
	Contient les fichiers d'une épreuve.

 * /challenges/<categorie>/<challenge>/NotAuthenticated
	Lorsqu'il est présent, ce fichier indique que le contenu de l'épreuve
	n'a pas pu être téléchargé car les informations d'authentification sont
	erronées.

 * /challenges/<categorie>/<challenge>/url
	Ce fichier contient l'URL de cette épreuve. Toutes les informations
	nécessaires à la résolution d'une épreuve ne sont pas forcément
	accessibles depuis le système de fichiers, il peut être utile d'ouvrir
	cette adresse dans un navigateur avec la commande :
	$ firefox $(cat url)
	ou tout autre navigateur.

 * /challenges/<categorie>/<challenge>/name
	Ce fichier contient le nom de l'épreuve.

 * /challenges/<categorie>/<challenge>/status
	Ce fichier contient l'une des 3 chaînes de caractères suivantes :
	- devnull
		si l'épreuve est supprimée ;
	- nonvalid
		si l'épreuve n'a pas été validée avec le compte actuel ;
	- valid
		si l'épreuve a été validée avec le compte actuel.

 * /challenges/<categorie>/<challenge>/lastvalidation
	Ce fichier contient le pseudo de la dernière personne à avoir validé
	cette épreuve. Ce fichier n'est présent que si l'authentification a pu
	se faire, que l'épreuve n'est pas /dev/nullée et qu'il y a au moins une
	validation.

 * /challenges/<categorie>/<challenge>/validations
	Ce fichier contient le nombre de validations pour cette épreuve.

 * /challenges/<categorie>/<challenge>/points
	Ce fichier contient le nombre de points que vaut une épreuve.

 * /challenges/<categorie>/<challenge>/quality
	Ce fichier contient la note attribuée à cette épreuve.

 * /challenges/<categorie>/<challenge>/vote
	Ce fichier contient le vote pour la qualité de l'épreuve. Ce fichier
	est accessible en lecture et écriture. Lorsqu'il est écrit, le vote est
	envoyé. Il n'apparaît que lorsque l'épreuve a été validée par le compte
	actuel.

 * /challenges/<categorie>/<challenge>/helpurl
	Ce fichier contient l'URL du topic d'aide du forum pour cette épreuve.
	Ce fichier n'est présent que si l'authentification a réussi.

 * /challenges/<categorie>/<challenge>/afterwardsurl
	Ce fichier contient l'URL du topic d'afterwards du forum pour cette
	épreuve. Accessible uniquement à ceux ayant réussi l'épreuve. Ce
	fichier n'est présent que si l'authentification a réussi et que
	l'épreuve a été validée.

 * /challenges/<categorie>/<challenge>/author
	Ce fichier contient le pseudo de l'auteur de l'épreuve. Ce fichier
	n'est présent que si l'authentification a réussi et que l'auteur de
	l'épreuve est connu.

 * /challenges/<categorie>/<challenge>/description.html
	Ce fichier contient le code HTML description de l'épreuve. Ce fichier
	n'est présent que si l'authentification a réussi.

 * /challenges/<categorie>/<challenge>/description
	Ce fichier contient la description de l'épreuve converti en texte brut.
	Le HTML ayant été converti, certaines épreuves peuvent ne pas être
	résolvables avec uniquement ce fichier. Ce fichier n'est présent que si
	l'authentification a réussi.

 * /challenges/<categorie>/<challenge>/summary
	Ce fichier contient un résumé de l'épreuve. Une compilation des
	informations utiles et réparties dans les différent fichiers
	sus-mentionnés. Ce fichier n'est présent que si l'authentification a
	réussi.