Changelog

Version 0.5.2

Note

La fonctionnalité d’écriture d’un fichier Epub reste complexe à maîtriser et doit être considérée comme étant encore un mode “beta”.

  • Correction d’un bug où certains fichiers de base étaient dupliqués (par exemple le fichier mimetype).
  • Correction d’un bug sous Windows concernant les chemins d’accès. Il est possible que d’autres usages d’os.path rendent la bibliothèque incompatible avec Windows (c’est un point qui sera amélioré dans une prochaine version).
  • Correction d’un bug permettant de lire des epubs utilisant (probablement à tort) le namespace “opf” dans sa description des méta-données.

Version 0.5.1

  • Il est désormais possible d’ouvrir un fichier epub qui ne contient pas de fichier NCX. Un warning est levé lorsqu’un tel fichier epub est ouvert.
  • Il est désormais possible d’ouvrir un fichier epub n’ayant pas d’UID. Un warning est levé lorsqu’un tel fichier epub est ouvert.

Version 0.5.0

De nouvelles amélioration, et quelques modifications :

  • Ajout de la méthode epub.EpubFile.check_mode_write() qui lève une exception si le fichier n’est pas ouvert en écriture.
  • Support de python 2.6 avec l’emploi du module ordereddict disponible sur pypi (http://pypi.python.org/pypi/ordereddict) (il manque des tests pour être certain du bon fonctionnement avec Python 2.6).
  • Nouvelle classe epub.Book servant de proxy pour simplifier et abstraire la manipulation du format epub. Fonctionnalité expérimentale.
  • Ajout de la méthode epub.EpubFile.extract_item() qui reprend le même principe que read_item() en l’appliquant à l’exctraction de fichiers.
  • Ajout de la fonction epub.utils.get_urlpath_part() permettant d’obtenir les deux parties des chemins des fichiers utilisés (entre autre) dans le fichier NCX ou l’élément spine du fichier OPF.
  • Support de Python 3.2, avec des test-unitaires passant avec Python 2.7 et Python 3.2.
  • Retrait de la notation des chaînes unicodes (le u devant les chaînes de caractères est retiré) dans la documentation.
  • Ajout d’un warning sur l’usage de la fonction epub.open() : fonction dépréciée. Il vaut mieux utiliser epub.open_epub() à la place, qui prend les mêmes paramètres, mais évite tout potentiel conflit avec la fonction python open().
  • Ajout d’une note sur la version et la compatibilité avec les versions de Python dans la documentation.

Il n’est plus possible d’utiliser la méthode epub.EpubFile.read avec un ManifestItem directement.

La fonction epub.open() est dépréciée et émet un warning. Il faut utiliser la fonction epub.open_epub() à la place.

Bug fix

Les bugs suivants ont été résolus :

  • Issue #2 : “Documentation pub on tutorial page.” La documentation ne fait plus de références à la méthode read dans ses exemples.
  • Issue #3 : “_parse_xml_metadata should not choke on absent firstChild” Une fonction a été ajoutée pour traiter la récupération de texte dans un noeud xml, et cette fonction est suffisament intelligente pour ne pas planter au premier texte manquant. Voir aussi epub.utils.get_node_text().

Version 0.4.0

Cette nouvelle version propose plusieurs petites améliorations, ainsi qu’une nouvelle fonctionnalité majeure : le mode écriture.

L’API n’est plus tout à fait la même, notamment les méthodes pour lire les fichiers ont changé un peu. Au vu des grands changements introduits par cette version, elle n’est pas compatible avec les versions précédentes.

De plus, cette version n’est compatible qu’avec Python 2.7. Il est prévu de supporter Python 2.6 dans une prochaine version.

  • La fonction epub.open() accepte un second paramètre mode pour choisir d’ouvrir le fichier en lecture seule ou en écriture.
  • La méthode epub.EpubFile.read() devient epub.EpubFile.read_item(). Cette méthode possède le même fonctionnement que l’ancienne, qui reprend sa fonctionnalité native de la classe zipfile.ZipFile.
  • La classe epub.opf.Manifest étend la classe collection.OrderedDict et plus la type dict. Ce changement n’est pas compatible avec une autre version que Python 2.7, mais un backport sera proposé prochainement.
  • Correction de divers bug, notamment sur le chargement des méta-données.
  • Une meilleure documentation du module epub.opf et epub.ncx.
  • Une couverture à 100% des tests unitaires.
  • Ajout de ce fichier de changelog.