{{tag>installation md5sum}}
----
====== Hashable Calculator ======

{{  http://stephane-huc.net/share/Hashable_Calculator/Hashable_Calculator.png?220x200|Interface de Hashable Calculator}}

**Hashable Calculator** est un logiciel sous licence GNU/GPL 3 de gestion de [[wpfr>Somme_de_contrôle|somme de contrôle]], écrit en langage Python, créé par [[utilisateurs:ste]].\\
Celui-ci apporte la gestion des différents algorithmes proposés par la bibliothèque Hashlib, de MD5 à SHA512.

===== Pré-requis =====
  * Disposer de [[:python]] (normalement installé par défaut sous Ubuntu)
  * Avoir [[:tutoriel:comment_installer_un_paquet|installé]] au minimum ces dépendances: **[[apt>python-glade|python-glade]]**, **[[apt>python-gtk2|python-gtk2]]**

===== Installation =====

  - Télécharger à partir de son dépôt [[https://framagit.org/hucste/Hashable|Git]]. 
  - Modifiez les [[:droits]] pour rendre exécutable le fichier **Hashable/Hashable.py** précédemment décompressé.

===== Utilisation =====

Pour utiliser **Hashable Calculator**, depuis le dossier où vous l'avez extrait et une fois que vous avez rendu exécutable le fichier Hashable.py, il vous suffit de cliquer dessus pour qu'il s'affiche à  votre écran.

Vous avez le choix entre :
  * **[[#Calculer]]** une somme de contrôle
  * **[[#Calculer un répertoire]]**
  * **[[#Contrôler]]** une somme de contrôle
  * **[[#Contrôler par fichier]]** de sommes de contrôle

Il est possible de modifier certaines préférences, pour cela aller dans le menu 'Éditer' > '[[#Préférences]]' //(ou CTRL+P)//

==== Calculer ====

**Calculer** permet de ... calculer une somme de contrôle.

  - Choisissez l'algorithme avec lequel vous désirez calculer.
  - Choisissez un ou plusieurs fichiers à calculer, grâce au Gestionnaire de fichiers
  - Une première fenêtre s'ouvre, vous restituant l'ensemble des fichiers sélectionnés. 
  * => Si vous cliquez sur le bouton [ Non ], la fenêtre se fermera et reviendra au Gestionnaire de fichiers.
  * => Si vous cliquez sur le bouton [ Oui ], la fenêtre se fermera et le programme calculera les sommes de contrôle
  - Une nouvelle fenêtre s'ouvre, vous restituant l'information de calcul, et vous proposant de sauvegarder dans un fichier, le(s) somme(s) de contrôle.
  - Si vous choisissez de sauvegarder, il sera créé un fichier, par défaut au format XML *, avec les informations caractéristiques de chacun des fichiers calculés. //* (Le format de fichier de sauvegarde peut-être modifié dans les préférences logicielles)//
  - Le nom, par défaut, du fichier est créé, à partir du premier fichier choisi - bien sûr, vous pouvez modifier ce nom. 
  - Ce fichier est enregistré, par défaut, dans le répertoire de l'application.

==== Calculer un répertoire ====

**Calculer un répertoire** permet de calculer ... tous les fichiers d'un répertoire.

  - Choisissez l'algorithme avec lequel vous désirez calculer.
  - Cochez la case 'récursif:', si vous désirez que le programme parcoure récursivement le répertoire, pour calculer aussi les sous-répertoires.
  - Choisissez le répertoire sur lequel vous désirez agir.
  - Cliquez sur le bouton [ Exécuter ]
  - Une nouvelle fenêtre s'ouvre, vous restituant l'information de calcul, et vous proposant de sauvegarder dans un fichier, les sommes de contrôle.
  - Si vous choisissez de sauvegarder, il sera créé un fichier, par défaut au format XML *, avec les informations caractéristiques de chacun des fichiers calculés. //* (Le format de fichier de sauvegarde peut-être modifié dans les préférences logicielles)//
  - Le nom, par défaut, du fichier est créé, à partir du répertoire choisi - bien sûr, vous pouvez modifier ce nom. 
  - Ce fichier est enregistré, par défaut, dans le répertoire de l'application.

==== Contrôler ====

**Contrôler ** permet de contrôler un seul fichier, en copiant-collant la somme de contrôle correspondante !

  - Choisissez l'algorithme nécessaire au contrôle
  - Copiez la somme de contrôle correspondante
  - Cliquez sur le bouton [ Exécuter ]

==== Contrôler par fichier ====

**Contrôler par fichier** permet de contrôler une série de fichiers, grâce au fichier XML généré par "**Hashable Calculator**". Ce fichier de sommes de contrôle peut aussi être au format texte, généré ou non par "**Hashable Calculator**"

Dans le cas du format de texte, celui-ci doit ABSOLUMENT être de format suivant - //autrement le programme considérera que la somme de contrôle est fausse// :
  * un ensemble 'somme de contrôle suivi d'un espace, suivi du nom du fichier' 
  * et un seul ensemble par ligne !

**Il est impératif que le fichier de sommes de contrôle, soit dans le même répertoire que les fichiers à contrôler !**

  - Choisissez votre fichier de sommes de contrôle.
  - Cliquez sur le bouton [ Exécuter ]
  - Une nouvelle fenêtre s'ouvre vous informant si les sommes de contrôles sont bonnes ou non:
    * Texte sur fond rouge :  la somme n'est pas bonne, ou le fichier correspondant n'existe pas !
    * Texte sur fond vert : la somme de contrôle est garantie !

==== Gestion des Préférences ====

Le menu 'Éditer' > 'Préférences', accessible aussi par la combinaison des touches CTRL+P, ouvre une fenêtre 'Préférences'.

Celle-ci vous permet de changer :
  * l'interface graphique : **il est nécessaire de redémarrer le logiciel pour en bénéficier** !
  * le format de fichier du fichier de sauvegarde des sommes de contrôle : TXT ou XML
  * le répertoire par défaut du gestionnaire de fichiers.


===== Désinstallation =====

Il suffit de supprimer le répertoire correspondant à "Hashable Calculator", nommé "Hashable", là où vous l'avez décompressé, après l'avoir téléchargé !

===== Ressources =====

  * [[https://framagit.org/hucste/Hashable|Page officielle du projet "Hashable Calculator"]]

----
//Contributeurs : [[utilisateurs:ste]]