nutools/lib/pyulib/migrate/tasks2/TiddlyWiki.py

#!/usr/bin/env python
# -*- coding: utf-8 -*-

u"""%(scriptname)s: gérer un TiddlyWiki

USAGE
    %(scriptname)s [options] addtext|addfile|remove|list|edit

OPTIONS
    -c twrc
        Charger le fichier de configuration twrc au lieu de la valeur par
        défaut (~/.utools/twrc)
    -f twfile.html
        Utiliser twfile.html au lieu de chercher un fichier par défaut dans le
        répertoire courant. Les noms considérés par défaut sont TODO.html,
        project_wiki.html et TiddlyWiki.html"""

__all__ = ('Tiddler', 'TiddlyWiki', 'TwCLI')

import os, sys, re
from os import path
from getopt import getopt
from time import localtime
from types import IntType, LongType, StringTypes
from xml.dom.minidom import parseString

from pyutools.config import ShConfigFile
from pyutools.dates import datef, TW_DATEF
from pyutools.iso8859 import quote_attr, quote_html, unquote_but_html
from pyutools import scriptdir, scriptname, dict, isnum, isstr, isseq
from pyutools import get_stdin_encoding, get_editor_encoding
from pyutools import ensure_unicode, uprint, enote, eerror, die, get_colored
from pyutools import edit_template

_marker = []

TW_PARAM_PATTERN = re.compile(
    r'(?:' +
    r'(?:"((?:(?:\\")|[^"])+)")|' + # "value"
    r"(?:'((?:(?:\\')|[^'])+)')|" + # 'value'
    r'(?:\[\[(.*?)\]\])|' + # [[space separated values]]
    r'(?:(\{\{.*?\}\}))|' + # {{braced values}}
    r'(?:([^"' + "'" + r'\s]\S*))|' + # value
    r'(?:"")|' + # ""
    r"(?:'')" + # ''
    r')'
    )
def twParseParams(s):
    params = []
    for a, b, c, d, e in TW_PARAM_PATTERN.findall(s):
        value = a or b or c or d or e
        if value: params.append(value)
    return params

def twParseTags(s):
    tags = {}
    for tag in twParseParams(s):
        tags[tag] = None
    return tags.keys()

TW_BRACED_VALUE = re.compile(r'\{\{.*\}\}$')
TW_VALUE = re.compile(r'[^"' + "'" + r'\s]\S*$')
def twFormatTags(tags):
    ss = []
    for tag in tags:
        if TW_BRACED_VALUE.match(tag): ss.append(tag)
        elif TW_VALUE.match(tag): ss.append(tag)
        else: ss.append("[[%s]]" % tag)
    return " ".join(ss)

class Tiddler:
    parent = None # Instance de TiddlyWiki parent de ce Tiddler
    title = u''
    modifier = u''
    creation_date = None
    modification_date = None
    tags = None
    attrs = None
    changecount = 0
    text = u''
    modified = False

    def __init__(self, element=None, parent=None):
        self.creation_date = self.modification_date = datef(TW_DATEF)
        self.tags = []
        self.attrs = {}
        if parent is not None:
            self.parent = parent
        if element is not None:
            self._parseElement(element)

    ATTRS = ['title', 'modifier', 'modification_date', 'tags', 'creation_date', 'changecount']
    ATTRS1_MAP = {'tiddler': 'title', 'modified': 'modification_date'}
    ATTRS1_REVMAP = {'title': 'tiddler', 'modification_date': 'modified', 'creation_date': None, 'changecount': None}
    ATTRS2_MAP = {'modified': 'modification_date', 'created': 'creation_date'}
    ATTRS2_REVMAP = {'modification_date': 'modified', 'creation_date': 'created'}

    def __unquote1(self, s):
        s = s.replace('\\n', '\n')
        return s
    def __quote1(self, s):
        s = s.replace('\n', '\\n')
        return s

    def __parseElement1(self, div, attrs):
        if attrs is not None:
            for i in range(attrs.length):
                name = div.attributes.item(i).name
                value = div.attributes.item(i).value
                name = self.ATTRS1_MAP.get(name, name)
                if name == 'tags': # cas particulier
                    value = twParseTags(value)
                if name in self.ATTRS: setattr(self, name, value)
                else: self.attrs[name] = value
        textNode = div.firstChild
        if textNode is not None:
            self.text = self.__unquote1(textNode.data)

    def __formatElement1(self):
        s = u'<div'
        for name in self.ATTRS:
            value = getattr(self, name)
            name = self.ATTRS1_REVMAP.get(name, name)
            if name is None: continue
            if name == 'tags': value = twFormatTags(value)
            s += ' %s="%s"' % (name, quote_attr(unicode(value)))
        for name, value in self.attrs.items():
            s += ' %s="%s"' % (name, quote_attr(unicode(value)))
        s += '>'
        s += quote_html(self.__quote1(self.text))
        s += '</div>'
        return s

    def __parseElement2(self, div, attrs):
        if attrs is not None:
            for i in range(attrs.length):
                name = attrs.item(i).name
                value = div.attributes.item(i).value
                name = self.ATTRS2_MAP.get(name, name)
                if name == 'tags': # cas particulier
                    value = twParseTags(value)
                if name in self.ATTRS: setattr(self, name, value)
                else: self.attrs[name] = value
        textNode = div.getElementsByTagName('pre')[0].firstChild
        if textNode is not None:
            self.text = textNode.data

    def __formatElement2(self):
        s = u'<div'
        for name in self.ATTRS:
            value = getattr(self, name)
            name = self.ATTRS2_REVMAP.get(name, name)
            if name is None: continue
            if name == 'tags': value = twFormatTags(value)
            s += ' %s="%s"' % (name, quote_attr(unicode(value)))
        for name, value in self.attrs.items():
            s += ' %s="%s"' % (name, quote_attr(unicode(value)))
        s += '>\n<pre>'
        s += quote_html(self.text)
        s += '</pre>\n</div>'
        return s

    def _parseElement(self, div, version=None):
        attrs = div.attributes
        if version is None:
            if attrs.getNamedItem('title') is not None: version = 2
            else: version = 1
            if self.parent is not None:
                self.parent.set_version(version)
        if version == 2: return self.__parseElement2(div, attrs)
        elif version == 1: return self.__parseElement1(div, attrs)

    def _formatElement(self, version=None):
        if version is None and self.parent is not None:
            version = self.parent.get_version()
        if version == 2: return self.__formatElement2()
        elif version == 1: return self.__formatElement1()

    def is_modified(self):
        return self.modified
    def set_modified(self):
        self.modification_date = datef(TW_DATEF)
        self.changecount = int(self.changecount) + 1
        self.modified = False

    def get_changecount(self):
        return self.changecount
    def set_changecount(self, changecount):
        if changecount != self.changecount:
            self.changecount = int(changecount)
            self.modified = True

    def get_title(self):
        return self.title
    def set_title(self, title):
        if title != self.title:
            self.title = ensure_unicode(title)
            self.modified = True

    def get_modifier(self):
        return self.modifier
    def set_modifier(self, modifier):
        if modifier != self.modifier:
            self.modifier = modifier
            self.modified = True

    def get_creation_date(self):
        return self.creation_date
    def set_creation_date(self, creation_date):
        if creation_date != self.creation_date:
            self.creation_date = creation_date
            self.modified = True

    def get_modification_date(self):
        return self.modification_date
    def set_modification_date(self, modification_date):
        if modification_date != self.modification_date:
            self.modification_date = modification_date
            self.modified = True

    def get_tags(self):
        return self.tags
    def set_tags(self, tags):
        if type(tags) in StringTypes: tags = twParseTags(tags)
        if set(tags) != set(self.tags):
            self.tags = tags
            self.modified = True
    def add_tag(self, tag):
        if tag not in self.tags:
            self.tags.append(tag)
            self.modified = True
    def remove_tag(self, tag):
        if tag in self.tags:
            self.tags.remove(tag)
            self.modified = True

    def get_attrs(self):
        return self.attrs
    def set_attrs(self, attrs):
        if attrs != self.attrs:
            self.attrs = attrs
            self.modified = True

    def get_text(self):
        return self.text
    def set_text(self, text):
        if text != self.text:
            self.text = ensure_unicode(text)
            self.modified = True

    def __repr__(self):#XXX
        s = self.get_title()
        if self.get_tags():
            s += "[%s]" % ",".join(self.get_tags())
        return s

class TiddlyWiki:
    DEFAULT_NAMES = ('TODO.html', 'project_wiki.html', 'TiddlyWiki.html')
    DEFAULT_NAME = DEFAULT_NAMES[1]

    valid = False
    file = pf = dirname = filename = None

    version = 2
    byname = None
    tiddlers = None

    def __init__(self, src=None, raise_exception=False, default_names=None):
        self.byname = {}
        self.tiddlers = []

        if default_names is None:
            default_names = self.DEFAULT_NAMES
        if src is None:
            for name in default_names:
                if path.exists(name):
                    src = name
                    break
        elif path.isdir(src):
            dir = src
            src = None
            for name in default_names:
                pf = path.join(dir, name)
                if path.exists(pf):
                    src = pf
                    break
        if src is None:
            if raise_exception:
                raise IOError("Impossible de trouver un TiddlyWiki par défaut")
            self.__update_file(self.DEFAULT_NAME)
        else:
            self.__update_file(src)
            self.load(raise_exception=raise_exception)

    def __update_file(self, file):
        self.file = file
        self.pf = path.abspath(self.file)
        self.dirname, self.filename = path.split(self.pf)

    MAGIC_PATTERN = re.compile(r'<!--\nTiddlyWiki')
    START_SAVE_AREA = '<div id="storeArea">'
    END_SAVE_AREA = '<!--POST-STOREAREA-->'
    START_DIV = '<div '
    END_DIV = '</div>'
    
    def __load_prefix_and_suffix(self, pf, raise_exception=True):
        try:
            inf = open(pf, 'rb')
            try:
                data = inf.read()
            finally:
                inf.close()

            ## Vérifier qu'il s'agit bien d'un tiddlywiki
            if not self.MAGIC_PATTERN.search(data):
                raise ValueError("Fichier de format incorrect: ce n'est pas un tiddlywiki: %s" % self.file)

            ## Vérifier la présence du storeArea
            # début
            pos = data.find(self.START_SAVE_AREA)
            if pos == -1:
                raise ValueError("%s: Impossible de trouver la zone de stockage" % self.file)
            pos += len(self.START_SAVE_AREA)
            self.prefix = data[:pos]
            data = data[pos:]
            # fin
            pos = 0
            while True:
                poss = data.find(self.START_DIV, pos)
                pose = data.find(self.END_DIV, pos)
                if pose == -1:
                    raise ValueError("%s: erreur de format à %i" % (self.file, pos))
                if poss != -1 and poss < pose:
                    # <div....</div>
                    pos = pose + len(self.END_DIV)
                else:
                    # end_save_area
                    break
            pos = data.find(self.END_DIV, pos)
            if pos == -1:
                raise ValueError("%s: Impossible de trouver la fin de la zone de stockage" % self.file)
            self.suffix = data[pos:]
            data = data[:pos]
            return True, data
        except:
            if raise_exception: raise
            return False, None

    def load(self, file=None, raise_exception=True):
        if file is not None: self.__update_file(file)

        self.valid = False
        data = self.__load_prefix_and_suffix(self.pf, raise_exception)[1]

        # charger les données
        self.valid = True

        self.byname = {}
        self.tiddlers = []

        data = self.START_SAVE_AREA + data + self.END_DIV
        data = unquote_but_html(data, "utf-8") # HACK: nécessaire car minidom
        # ne supporte pas les entities. utf-8 est codé en dur parce qu'on sait que
        # TiddlyWiki enregistre dans ce codec.
        dom = parseString(data)
        for node in dom.documentElement.getElementsByTagName('div'):
            self.add(Tiddler(element=node, parent=self))

        return True
    
    def is_valid(self):
        return self.valid
    
    def save(self, file=None, templatefile=None, set_modified=True, raise_exception=True):
        if templatefile is None and self.file is None:
            templatefile = path.join(path.split(__file__)[0], 'empty.html')
        if templatefile is None:
            if not hasattr(self, 'prefix') or not hasattr(self, 'suffix'):
                raise IOError("Etat inconsistant: il faut le préfixe et le suffixe")
        else:
            self.__load_prefix_and_suffix(templatefile, raise_exception)
            
        if file is not None: self.__update_file(file)
        tmppf = self.pf + '.tmp'
        
        try:
            outf = open(tmppf, 'wb')
            try:
                outf.write(self.prefix)
                for tiddler in self.tiddlers:
                    if tiddler.is_modified() and set_modified:
                        tiddler.set_modified()
                    outf.write(tiddler._formatElement().encode("utf-8"))
                    outf.write("\n")
                outf.write(self.suffix)
            finally:
                outf.close()
            os.rename(tmppf, self.pf)
        except:
            if raise_exception: raise

    def set_version(self, version):
        self.version = version
    def get_version(self):
        return self.version

    def __len__(self):
        return len(self.tiddlers)
    def has_key(self, title):
        return self.byname.has_key(title)
    def __getitem__(self, indexOrTitle, default=_marker):
        if isnum(indexOrTitle):
            return self.tiddlers[indexOrTitle]
        else:
            if default is _marker: return self.byname[indexOrTitle]
            else: return self.byname.get(indexOrTitle, default)
    get = __getitem__
    def add(self, tiddler):
        if not isinstance(tiddler, Tiddler):
            raise ValueError("value doit être une instance de Tiddler")
        title = tiddler.get_title()
        if title in self.byname:
            del self.tiddlers[self.byname[title]]
        tiddler.parent = self
        self.tiddlers.append(tiddler)
        self.byname[title] = tiddler
    def __delitem__(self, indexOrTitle):
        if isnum(indexOrTitle):
            tiddler = self.tiddlers[indexOrTitle]
            index = indexOrTitle
        else:
            tiddler = self.byname[indexOrTitle]
            index = self.tiddlers.index(tiddler)
        del self.byname[tiddler.get_title()]
        del self.tiddlers[index]

    def __repr__(self):
        return repr(map(lambda t: t.get_title(), self.tiddlers))

################################################################################

class TwrcFile(ShConfigFile):
    TWRC = "twrc"

    def __init__(self, file=None, raise_exception=True):
        if file is None:
            testdir = path.join(scriptdir, "test")
            utoolsrcdir = path.join(path.expanduser("~"), ".utools")
            if path.isdir(testdir): file = path.join(testdir, self.TWRC)
            else: file = path.join(utoolsrcdir, self.TWRC)
            raise_exception = False
        ShConfigFile.__init__(self, file=file, raise_exception=raise_exception)
        
    DEFAULT_NAMES = "default_names"
    MODIFIER = "modifier"

    def __p(self, p, refdir=None):
        if refdir is not None:
            if not path.isdir(refdir): refdir = path.split(refdir)[0]
        p = path.normpath(path.expanduser(p))
        if refdir is not None:
            p = path.join(refdir, p)
        return p
    
    COMMA_PATTERN = re.compile(r'\s*,\s*')
    def __vs(self, vs):
        if isstr(vs): vs = self.COMMA_PATTERN.split(vs)
        return tuple(vs)
    def __csv(self, csv):
        if isseq(csv): csv = ','.join(csv)
        return ensure_unicode(csv)
    
    def get_default_names(self):
        if self.has_key(self.DEFAULT_NAMES): return self.__vs(self[self.DEFAULT_NAMES])
        else: return TiddlyWiki.DEFAULT_NAMES
    def set_default_names(self, default_names=None):
        if default_names is None:
            if self.has_key(self.DEFAULT_NAMES): del self[self.DEFAULT_NAMES]
        else:
            self[self.DEFAULT_NAMES] = self.__csv(default_names)
        
    def get_modifier(self):
        if self.has_key(self.MODIFIER): return self[self.MODIFIER]
        else: return os.environ.get('USER', 'TiddlyWiki.py')
    def set_modifier(self, modifier=None):
        if modifier is None:
            if self.has_key(self.MODIFIER): del self[self.MODIFIER]
        else:
            self[self.MODIFIER] = modifier

class TwCLI:
    twrc = None

    def __newTiddlyWiki(self, file=None):
        return TiddlyWiki(file, default_names=self.twrc.get_default_names(), raise_exception=True)

    twfile = None
    def __twfile(self):
        if self.twfile is None:
            self.twfile = self.__newTiddlyWiki()
        return self.twfile

    def __init__(self, twrc=None):
        if not isinstance(twrc, TwrcFile):
            twrc = TwrcFile(twrc)
        self.twrc = twrc

    CONFOPT = 'c:f:'
    CONFLOPT = ['config=', 'file=']
    
    def is_global_option(self, opt, value):
        if opt in ('-c', '--config'):
            self.twrc = TwrcFile(value)
        elif opt in ('-f', '--file'):
            self.twfile = self.__newTiddlyWiki(value)
        else:
            return False
        return True

    def ADDTEXT(self,
                title=None, text=None,
                modifier=None,
                set_tags=None, add_tags=None, remove_tags=None,
                encoding=None,
                argv=(), scriptname=None,
                **kw):
        u"""%(scriptname)s: Créer ou mettre à jour un tiddler

USAGE
    %(scriptname)s [options] title
    
OPTIONS
    -m text
        Si le texte du tiddler est spécifié, on ne lance pas d'éditeur
    -u modifier
        Spécifier le nom de l'utilisateur qui fait la modification. Par défaut,
        il s'agit de $USER
    -t tag
        tag: ajouter un tag, -tag: enlever un tag
    -e encoding
        Spécifier l'encoding du titre et du texte s'il sont spécifiés sur la
        ligne de commande. Par défaut, on considère que les données sont
        encodées en %(default_encoding)s"""
        default_encoding = get_stdin_encoding()
        opts, argv = getopt(argv,
                            self.CONFOPT + 'hm:u:t:e:',
                            self.CONFLOPT + ['help', 'text=', 'modifier=', 'tag=', 'encoding='])
        for opt, value in opts:
            if self.is_global_option(opt, value):
                pass
            elif opt in ('-h', '--help'):
                uprint(self.LIST.__doc__ % locals())
                sys.exit(0)
            elif opt in ('-m', '--text'):
                text = value
            elif opt in ('-u', '--modifier'):
                modifier = value
            elif opt in ('-t', '--tag'):
                if value.startswith('-'):
                    if remove_tags is None: remove_tags = []
                    remove_tags.append(value[1:])
                else:
                    if value.startswith('+'): value = value[1:]
                    if add_tags is None: add_tags = []
                    add_tags.append(value)
            elif opt in ('-e', '--encoding'):
                encoding = value
    
        if title is None:
            if not argv:
                raise ValueError("Il faut spécifier un titre pour le nouveau tiddler")
            title = argv[0]

        edit = False
        if text is None:
            text = ''
            edit = True
        if modifier is None:
            modifier = self.twrc.get_modifier()
        if encoding is None:
            encoding = default_encoding
        title = ensure_unicode(title, encoding)
        text = ensure_unicode(text, encoding)

        twfile = self.__twfile()

        new_tiddler = False
        tiddler = twfile.get(title, None)
        if tiddler is None:
            new_tiddler = True
            tiddler = Tiddler()
            twfile.add(tiddler)
            
        tiddler.set_title(title)
        tiddler.set_text(text)
        tiddler.set_modifier(modifier)
        if set_tags is not None:
            tiddler.set_tags(set_tags)
        if add_tags is not None:
            for tag in add_tags:
                tiddler.add_tag(tag)
        if remove_tags is not None:
            for tag in remove_tags:
                tiddler.remove_tag(tag)
    
        if tiddler.is_modified():
            twfile.save()
            if edit:
                self.EDIT(tiddler=tiddler)
            else:
                if new_tiddler: enote(u"Ajout d'un nouveau tiddler '%s'" % title)
                else: enote(u"Mise à jour du tiddler '%s'" % title)
    
    def ADDFILE(self,
                file=None, title=None,
                modifier=None,
                set_tags=None, add_tags=None, remove_tags=None,
                encoding=None,
                argv=(), scriptname=None,
                **kw):
        u"""%(scriptname)s: Créer ou mettre à jour un tiddler à partir d'un fichier

USAGE
    %(scriptname)s [options] /path/to/file

OPTIONS
    -n title
        Spécifier le titre du tiddler. Par défaut, il s'agit du nom du fichier
    -u modifier
        Spécifier le nom de l'utilisateur qui fait la modification. Par défaut,
        il s'agit de $USER
    -t tag
        Ajouter un tag
        Si le fichier a l'extension .js, on ajoute automatiquement le tag
        systemConfig, sauf si un tag est spécifié
    -e encoding
        Spécifier l'encoding du fichier. Par défaut, on lit en %(default_encoding)s"""
        default_encoding = get_editor_encoding()
        opts, argv = getopt(argv,
                            self.CONFOPT + 'hn:u:t:e:',
                            self.CONFLOPT + ['help', 'title=', 'modifier=', 'tag=', 'encoding='])
        for opt, value in opts:
            if self.is_global_option(opt, value):
                pass
            elif opt in ('-h', '--help'):
                uprint(self.LIST.__doc__ % locals())
                sys.exit(0)
            elif opt in ('-n', '--title'):
                title = value
            elif opt in ('-u', '--modifier'):
                modifier = value
            elif opt in ('-t', '--tag'):
                if value.startswith('-'):
                    if remove_tags is None: remove_tags = []
                    remove_tags.append(value[1:])
                else:
                    if value.startswith('+'): value = value[1:]
                    if add_tags is None: add_tags = []
                    add_tags.append(value)
            elif opt in ('-e', '--encoding'):
                encoding = value

        if file is None:
            if not argv:
                raise ValueError("Il faut spécifier un fichier à importer")
            file = argv[0]
        if not path.exists(file):
            raise IOError("Fichier inexistant: %s" % file)
        
        if title is None:
            title = file
        if modifier is None:
            modifier = os.environ.get('USER', 'TiddlyWiki.py')
        if path.splitext(file)[1] == '.js':
            if set_tags is not None:
                set_tags.append('systemConfig')
            else:
                if add_tags is None: add_tags = []
                add_tags.append('systemConfig')
        if encoding is None:
            encoding = defaut_encoding

        inf = open(file, 'rb')
        try:
            text = ensure_unicode(inf.read(), encoding)
        finally:
            inf.close()

        twfile = self.__twfile()

        new_tiddler = False
        tiddler = twfile.get(title, None)
        if tiddler is None:
            new_tiddler = True
            tiddler = Tiddler()
            twfile.add(tiddler)
            
        tiddler.set_title(title)
        tiddler.set_modifier(modifier)
        if set_tags is not None:
            tiddler.set_tags(set_tags)
        if add_tags is not None:
            for tag in add_tags:
                tiddler.add_tag(tag)
        if remove_tags is not None:
            for tag in remove_tags:
                tiddler.remove_tag(tag)
        tiddler.set_text(text)
        
        if tiddler.is_modified():
            twfile.save()
            if new_tiddler: enote(u"Ajout d'un nouveau tiddler '%s'" % title)
            else: enote(u"Mise à jour du tiddler '%s'" % title)
    
    def REMOVE(self,
               title=None,
               argv=(), scriptname=None,
               **kw):
        u"""%(scriptname)s: Supprimer un tiddler

USAGE
    %(scriptname)s title"""
        opts, argv = getopt(argv,
                            self.CONFOPT + 'hn:',
                            self.CONFLOPT + ['help', 'title='])
        for opt, value in opts:
            if self.is_global_option(opt, value):
                pass
            elif opt in ('-h', '--help'):
                uprint(self.LIST.__doc__ % locals())
                sys.exit(0)
            elif opt in ('-n', '--title'):
                title = value

        if title is None:
            if not argv:
                raise ValueError("Il faut spécifier le tiddler à supprimer")
            title = argv[0]

        twfile = self.__twfile()
        if twfile.has_key(title):
            del twfile[title]
            twfile.save()
            enote(u"Suppression du tiddler '%s'" % title)

    def LIST(self,
             showtext=False,
             argv=(), scriptname=None,
             **kw):
        u"""%(scriptname)s: Lister les tiddlers
        
USAGE
    %(scriptname)s
    
OPTIONS
    -l  Afficher aussi le contenu des tiddlers"""
        opts, argv = getopt(argv,
                            self.CONFOPT + 'hl',
                            self.CONFLOPT + ['help', 'show-text'])
        for opt, value in opts:
            if self.is_global_option(opt, value):
                pass
            elif opt in ('-h', '--help'):
                uprint(self.LIST.__doc__ % locals())
                sys.exit(0)
            elif opt in ('-l', '--show-text'):
                showtext = True
        
        twfile = self.__twfile()
        if showtext:
            for tiddler in twfile:
                title = get_colored(u'>>> ' + tiddler.get_title(), 'b')
                if tiddler.get_tags():
                    title += " [%s]" % ', '.join(map(lambda t: get_colored(tiddler, 'y'), tiddler.get_tags()))
                uprint(title)
                
                text = tiddler.get_text()
                if text: uprint(text)
        else:
            for tiddler in twfile:
                uprint(tiddler.get_title())
    
    EDIT_TEMPLATE = u"""
EDIT: ----------------------------------------------------------------
EDIT: Saisissez ou modifiez le titre et le corps du tiddler.
EDIT:
EDIT: - Les lignes commencant par 'EDIT:' seront supprimées automatiquement
EDIT: - La ligne tags: peut être modifiée si nécessaire.
EDIT:
EDIT: ----------------------------------------------------------------"""

    TAGS_PATTERN = re.compile(r'##\s*tags:\s*')
    
    def __nblines(self, s):
        lines = s.split("\n")
        nblines = len(lines)
        if not lines[-1]: nblines -= 1
        return nblines

    def EDIT(self, 
             title=None,
             tiddler=None,
             argv=(), scriptname=None,
             **kw):
        u"""%(scriptname)s: Editer un tiddler

USAGE
    %(scriptname)s title"""
        opts, argv = getopt(argv,
                            self.CONFOPT + 'h',
                            self.CONFLOPT + ['help'])
        for opt, value in opts:
            if self.is_global_option(opt, value):
                pass
            elif opt in ('-h', '--help'):
                uprint(self.LIST.__doc__ % locals())
                sys.exit(0)
        
        twfile = self.__twfile()
        if tiddler is None:
            if title is None:
                if not argv:
                    raise ValueError("Il faut spécifier le tiddler à éditer")
                title = argv[0]
            tiddler = twfile.get(title, None)
            if tiddler is None:
                raise ValueError("Tiddler non trouvé: %s" % title)
        
        template = u""
        template += u"## tags: %s\n" % twFormatTags(tiddler.get_tags())
        template += u"\n"
        
        title = tiddler.get_title()
        template += u"%s\n" % title
        setline = self.__nblines(template)
        setcol = len(title)
        
        text = tiddler.get_text()
        if text: template += u"\n%s\n" % text
        
        template += self.EDIT_TEMPLATE
        lines = edit_template(template, 'EDIT:', setline, setcol).split('\n')

        new_tags = []
        parsing_tags = True
        skip_empty = True
        text = []
        for line in lines:
            if skip_empty and not line: continue
            if parsing_tags:
                mot = self.TAGS_PATTERN.match(line)
                if mot is not None:
                    new_tags.extend(twParseTags(line[mot.end():]))
                    continue
                else:
                    parsing_tags = False
            skip_empty = False
            text.append(line)
        text = "\n".join(text)
        pos = text.find('\n\n')
        if pos == -1:
            title = text.replace('\n', ' ')
            text = u''
        else:
            title = text[:pos].replace('\n', ' ')
            text = text[pos + 2:]

        tiddler.set_tags(new_tags)
        tiddler.set_title(title)
        tiddler.set_text(text)
        
        if tiddler.is_modified():
            twfile.save()
            enote(u"Mise à jour du tiddler '%s'" % title)

################################################################################

if __name__ == '__main__':
    debug = False
    action = None
    argv = sys.argv[1:]
    twCLI = TwCLI()

    # Essayer de determiner l'action avec le nom du script
    if scriptname in ('twa', ):
        action = 'addtext'
    elif scriptname in ('twf', ):
        action = 'addfile'
    elif scriptname in ('twl', 'twll',):
        if scriptname == 'twll': argv.insert(0, '-l')
        action = 'list'
    elif scriptname in ('twe', ):
        action = 'edit'

    if action is None:
        opts, argv = getopt(argv,
                            TwCLI.CONFOPT + 'hD',
                            TwCLI.CONFLOPT + ['help', 'debug'])
        for opt, value in opts:
            if opt in ('-h', '--help'):
                uprint(__doc__ % dict(scriptname=scriptname))
                sys.exit(0)
            elif twCLI.is_global_option(opt, value):
                pass
            elif opt in ('-D', '--debug'):
                debug = True

        if not argv:
            uprint(__doc__ % dict(scriptname=scriptname))
            sys.exit(0)

        action, argv = argv[0], argv[1:]
        if action in ('addtext', 'add', 'a'):
            action = 'addtext'
        elif action in ('addfile', 'file', 'f'):
            action = 'addfile'
        elif action in ('remove', 'r'):
            action = 'remove'
        elif action in ('list', 'l', 'll'):
            if action == 'll': argv.insert(0, '-l')
            action = 'list'
        elif action in ('edit', 'e'):
            action = 'edit'
        else:
            eerror("Action inconnue: %s" % action)
            sys.exit(1)

    if scriptname in ('TiddlyWiki.py', 'tw'):
        # pour l'affichage de l'aide
        scriptname = '%s %s' % (scriptname, action)

    try:
        apply(getattr(twCLI, action.upper()), (), {'argv': argv, 'scriptname': scriptname})
    except Exception, e:
        if debug:
            eerror(e[0])
            import traceback
            traceback.print_exc()
        else:
            die(e[0])