patacrep/songbook_core/content/song.py

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

"""Plugin to include songs to the songbook."""

import glob
import jinja2
import logging
import os

from songbook_core.content import Content, process_content, ContentError
from songbook_core import files
from songbook_core.songs import Song

LOGGER = logging.getLogger(__name__)

class SongRenderer(Content, Song):
    """Render a song in the .tex file."""

    def begin_new_block(self, previous, __context):
        """Return a boolean stating if a new block is to be created."""
        return not isinstance(previous, SongRenderer)

    def begin_block(self, context):
        """Return the string to begin a block."""
        indexes = context.resolve("indexes")
        if isinstance(indexes, jinja2.runtime.Undefined):
            indexes = ""
        return r'\begin{songs}{%s}' % indexes

    def end_block(self, __context):
        """Return the string to end a block."""
        return r'\end{songs}'

    def render(self, context):
        """Return the string that will render the song."""
        return r'\input{{{}}}'.format(files.relpath(
            self.path,
            os.path.dirname(context['filename'])
            ))

#pylint: disable=unused-argument
def parse(keyword, argument, contentlist, config):
    """Parse data associated with keyword 'song'.

    Arguments:
    - keyword: unused;
    - argument: unused;
    - contentlist: a list of strings, which are interpreted as regular
      expressions (interpreted using the glob module), referring to songs.
    - config: the current songbook configuration dictionary.

    Return a list of SongRenderer() instances.
    """
    if 'languages' not in config:
        config['_languages'] = set()
    songlist = []
    for songdir in config['_songdir']:
        if contentlist:
            break
        contentlist = [
                files.relpath(filename, songdir)
                for filename
                in files.recursive_find(songdir, "*.sg")
                ]
    for elem in contentlist:
        before = len(songlist)
        for songdir in config['_songdir']:
            for filename in glob.iglob(os.path.join(songdir, elem)):
                LOGGER.debug('Parsing file "{}"…'.format(filename))
                song = SongRenderer(filename, config)
                songlist.append(song)
                config["_languages"].update(song.languages)
            if len(songlist) > before:
                break
        if len(songlist) == before:
            # No songs were added
            LOGGER.warning(
                    "Expression '{}' did not match any file".format(elem)
                    )
    return songlist


CONTENT_PLUGINS = {'song': parse}


class OnlySongsError(ContentError):
    "A list that should contain only songs also contain other type of content."
    def __init__(self, not_songs):
        super(OnlySongsError, self).__init__()
        self.not_songs = not_songs

    def __str__(self):
        return (
                "Only songs are allowed, and the following items are not:" +
                str(self.not_songs)
                )

def process_songs(content, config=None):
    """Process content that containt only songs.

    Call songbook_core.content.process_content(), checks if the returned list
    contains only songs, and raise an exception if not.
    """
    contentlist = process_content(content, config)
    not_songs = [
            item
            for item
            in contentlist
            if not isinstance(item, SongRenderer)
            ]
    if not_songs:
        raise OnlySongsError(not_songs)
    return contentlist