quotes.py

   1 #!/usr/bin/env python
   2 # -*- encoding: utf-8 -*-
   3
   4 """ Gestion des quotes """
   5
   6 import datetime
   7 import time
   8 import re
   9 import json
  10 import random
  11
  12 import config
  13
  14 quote_matcher = re.compile(config.quote_regexp, flags=re.UNICODE)
  15 quote_matcher_with_timestamp = re.compile(config.quote_regexp_with_timestamp, flags=re.UNICODE)
  16 spaces_matcher = re.compile(u"\s", flags=re.U)
  17
  18 def equivalence_partition(iterable, relation):
  19     """ Partitionne l'itérable en classes d'équivalences. """
  20     classes = []
  21     for o in iterable:
  22         # find the class it is in
  23         found = False
  24         for c in classes:
  25             if relation( iter(c).next(), o ): # is it equivalent to this class?
  26                 c.add( o )
  27                 found = True
  28                 break
  29         if not found: # it is in a new class
  30             classes.append( set( [ o ] ) )
  31     return classes
  32
  33 def get_now():
  34     """ Renvoie la date actuelle """
  35     return datetime.datetime(*time.localtime()[:6])
  36
  37 def sanitize_author(raw):
  38     """Proprifie l'auteur : enlève les espaces insécables."""
  39     return spaces_matcher.sub(u" ", raw)
  40
  41 class Quote(object):
  42     """ Une citation """
  43     def __init__(self, author, content, timestamp=None, place=None, quoter=None):
  44         if timestamp is None:
  45             timestamp = get_now()
  46         elif isinstance(timestamp, basestring):
  47             timestamp = datetime.datetime(*time.strptime(timestamp, u"%Y-%m-%d_%H:%M:%S")[:6])
  48         self.author = sanitize_author(author)
  49         self.content = content
  50         self.timestamp = timestamp
  51         self.place = place
  52         self.quoter = quoter
  53
  54     def jsonize(self):
  55         d = {"author" : self.author, "content" : self.content,
  56              "timestamp" : self.timestamp.strftime(u"%F_%T"),
  57              "place" : self.place, "quoter" : self.quoter}
  58         return d
  59
  60     def __unicode__(self):
  61         """ Retourne la quote affichable """
  62         return config.quote_template % self.__dict__
  63     def __str__(self):
  64         return unicode(self).encode("utf-8")
  65
  66     def full_str(self):
  67         """ Retourne une chaîne représentant la totalité des infos de la quote,
  68             tout en étant parsable et human-readable. """
  69         place = self.place if self.place else ""
  70         quoter = self.quoter if self.quoter else ""
  71         return (u"%s %s | %s | %s" % (self.timestamp.strftime("%F_%T"), unicode(self), place, quoter)).encode("utf-8")
  72
  73     def __eq__(self, otherquote):
  74         """ Vérifie si cette phrase n'a pas déjà été dite par la même personne.
  75             Indépendamment de la date et de la casse. """
  76         return [self.author.lower(), self.content.lower()] == [otherquote.author.lower(), otherquote.content.lower()]
  77
  78
  79 def parse(text, date=None):
  80     """ Parse le ``text`` et renvoie une quote ou None. """
  81     if date == None:
  82         date = get_now()
  83     get = quote_matcher.match(text)
  84     if not get is None:
  85         d = get.groupdict()
  86         return Quote(d["author"], d["content"], date)
  87
  88 def load_file(filename):
  89     """ Récupère les quotes depuis le fichier """
  90     with open(filename) as f:
  91         jsonquotes = json.load(f)
  92         quotes = [Quote(**q) for q in jsonquotes]
  93     return quotes
  94
  95 def save_file(quotes, filename):
  96     """ Enregistre les quotes dans le fichier """
  97     with open(filename, "w") as f:
  98         raws = [q.jsonize() for q in quotes]
  99         json.dump(raws, f)
 100
 101 class QuoteDB(object):
 102     """ Stocke et distribue des quotes. """
 103     def __init__(self):
 104         self.quotelist = []
 105
 106     def load(self):
 107         """ Charge le fichier de quotes dans la DB """
 108         self.quotelist = load_file(config.quote_file)
 109
 110     def save(self):
 111         """ Sauvegarde la DB dans le fichier de quotes """
 112         save_file(self.quotelist, config.quote_file)
 113
 114     def _collapse_author(self, author):
 115         """ Renvoie ``author`` avec la casse déjà utilisée si il a déjà été quoté
 116             sinon, le renvoie sans le modifier. """
 117         authors = list(set([q.author for q in self.quotelist if q.author.lower() == author.lower()]))
 118         if len(authors) > 1:
 119             print "Warning : authors %s" % authors
 120         if authors:
 121             return authors[0]
 122         else:
 123             return author
 124
 125     def get_clash_authors(self):
 126         """ Renvoie une liste de liste d'auteurs qui sont enregistrés avec des casses différentes. """
 127         authors = list(set([q.author for q in self.quotelist]))
 128         authors = equivalence_partition(authors, lambda x,y: x.lower() == y.lower())
 129         authors = [list(c) for c in authors if len(c) > 1]
 130         return authors
 131
 132     def store(self, timestamp=None, **kwargs):
 133         """ Enregistre une nouvelle quote, sauf si elle existe déjà.
 134             Force l'auteur à utiliser la même casse si un auteur de casse différente existait déjà.
 135             Renvoie ``True`` si elle a été ajoutée, ``False`` si elle existait. """
 136         kwargs["author"] = self._collapse_author(kwargs["author"])
 137         kwargs["timestamp"] = timestamp
 138         newquote = Quote(**kwargs)
 139         if not newquote in self.quotelist:
 140             self.quotelist.append(newquote)
 141             return True
 142         return False
 143
 144     def __repr__(self):
 145         return repr(self.quotelist)
 146
 147     def random(self):
 148         """ Sort une quote aléatoire """
 149         return random.choice(self.quotelist)
 150
 151     def quotesfrom(self, author):
 152         """ Sort toutes les quotes de ``author`` """
 153         return [q for q in self.quotelist if q.author == author]
 154     def randomfrom(self, author):
 155         """ Sort une quote aléatoire de ``author`` """
 156         return random.choice(self.quotesfrom(author))
 157
 158     def search(self, inquote=None, author=None, regexp=False):
 159         """Fait une recherche dans les quotes."""
 160         if regexp:
 161             if inquote is None:
 162                 inquote = ".*"
 163             if author is None:
 164                 author = ".*"
 165             qreg = re.compile(inquote, flags=re.UNICODE)
 166             areg = re.compile(author, flags=re.UNICODE)
 167             l = [q for q in self.quotelist if qreg.match(q.content) and areg.match(q.author)]
 168         else:
 169             if inquote is None:
 170                 inquote = ""
 171             if author is None:
 172                 author = ""
 173             l = [q for q in self.quotelist if inquote in q.content and author in q.author]
 174         return l
 175
 176     def search_authors(self, author=None, regexp=False):
 177         """Renvoie la liste des auteurs contenant ``author`` ou qui matchent la regexp."""
 178         if regexp:
 179             if author is None:
 180                 author = ".*"
 181             areg = re.compile(author, flags=re.UNICODE)
 182             l = list(set([q.author for q in self.quotelist if areg.match(q.author)]))
 183         else:
 184             if author is None:
 185                 author = ""
 186             l = list(set([q.author for q in self.quotelist if author in q.author]))
 187         return l
 188
 189 def dump(quotedb, dump_file=None):
 190     """Pour exporter les quotes dans un format readable vers un fichier."""
 191     if dump_file is None:
 192         dump_file = config.quote_dump_file
 193     t = "\n".join([q.full_str() for q in quotedb.quotelist]) + "\n"
 194     with open(dump_file, "w") as f:
 195         f.write(t)
 196
 197 def restore(dump_file=None):
 198     """Crée un DB de quotes en parsant le contenu d'un fichier de dump."""
 199     if dump_file is None:
 200         dump_file = config.quote_dump_file
 201     with open(dump_file) as f:
 202         t = f.read()
 203     t = t.decode("utf-8") # Oui, ça peut fail, mais on ne doit alors pas continuer
 204     l = [m.groupdict() for m in quote_matcher_with_timestamp.finditer(t)]
 205     # On instancie les quotes grâce aux dicos qui ont déjà la bonne tronche
 206     l = [Quote(**q) for q in l]
 207     newquotedb = QuoteDB()
 208     newquotedb.quotelist = l
 209     return newquotedb