1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/moinformat/translators/__init__.py Thu Aug 17 23:34:10 2023 +0200
1.3 @@ -0,0 +1,52 @@
1.4 +#!/usr/bin/env python
1.5 +
1.6 +"""
1.7 +Document format translators.
1.8 +
1.9 +Copyright (C) 2017, 2018, 2023 Paul Boddie <paul@boddie.org.uk>
1.10 +
1.11 +This program is free software; you can redistribute it and/or modify it under
1.12 +the terms of the GNU General Public License as published by the Free Software
1.13 +Foundation; either version 3 of the License, or (at your option) any later
1.14 +version.
1.15 +
1.16 +This program is distributed in the hope that it will be useful, but WITHOUT
1.17 +ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
1.18 +FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
1.19 +details.
1.20 +
1.21 +You should have received a copy of the GNU General Public License along with
1.22 +this program. If not, see <http://www.gnu.org/licenses/>.
1.23 +"""
1.24 +
1.25 +from moinformat.translators.manifest import translators
1.26 +
1.27 +# Top-level functions.
1.28 +
1.29 +def get_translator(name, doctype=None):
1.30 +
1.31 + """
1.32 + Return a translator class producing nodes whose document type has the given
1.33 + 'name'. If 'doctype' is indicated, obtain a translator class specific to
1.34 + that document type. Otherwise, a general translator for Moin content is
1.35 + obtained.
1.36 + """
1.37 +
1.38 + return translators["%s.%s" % (name, doctype or "moin")]
1.39 +
1.40 +def make_translator(metadata, doctype=None):
1.41 +
1.42 + """
1.43 + Return a translator instance using the given 'metadata' and optional output
1.44 + 'doctype'.
1.45 + """
1.46 +
1.47 + return metadata.get_translator(doctype)
1.48 +
1.49 +def translate(doc, translator):
1.50 +
1.51 + "Translate 'doc' using the given 'translator' instance."
1.52 +
1.53 + return doc.visit(translator)
1.54 +
1.55 +# vim: tabstop=4 expandtab shiftwidth=4