X-Git-Url: http://git.tremily.us/?p=hooke.git;a=blobdiff_plain;f=hooke%2Fplugin%2Fplaylist.py;h=43978b5669f7eba4f58fbb43241fa2dbb6090309;hp=a374e0885c96986a44fc4590fb0c2dca2250370a;hb=e57e6aa9b86351398b3af9a24513169395a71522;hpb=d72a56793bf058b2a8ee735ac67c1b7ecaa7819a diff --git a/hooke/plugin/playlist.py b/hooke/plugin/playlist.py index a374e08..43978b5 100644 --- a/hooke/plugin/playlist.py +++ b/hooke/plugin/playlist.py @@ -1,25 +1,48 @@ -"""The `playlist` module provides :class:`PlaylistPlugin` several -associated :class:`hooke.command.Command`\s for handling +# Copyright (C) 2010 W. Trevor King +# +# This file is part of Hooke. +# +# Hooke is free software: you can redistribute it and/or modify it +# under the terms of the GNU Lesser General Public License as +# published by the Free Software Foundation, either version 3 of the +# License, or (at your option) any later version. +# +# Hooke is distributed in the hope that it will be useful, but WITHOUT +# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY +# or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General +# Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public +# License along with Hooke. If not, see +# . + +"""The ``playlist`` module provides :class:`PlaylistPlugin` and +several associated :class:`hooke.command.Command`\s for handling :mod:`hooke.playlist` classes. """ import glob +import logging +import os.path from ..command import Command, Argument, Failure -from ..playlist import FilePlaylist -from ..plugin import Builtin +from ..curve import NotRecognized +from ..playlist import load +from ..util.itertools import reverse_enumerate +from . import Builtin class PlaylistPlugin (Builtin): def __init__(self): super(PlaylistPlugin, self).__init__(name='playlist') - - def commands(self): - return [NextCommand(), PreviousCommand(), JumpCommand(), - IndexCommand(), CurveListCommand(), - SaveCommand(), LoadCommand(), - AddCommand(), AddGlobCommand(), - RemoveCommand(), FilterCommand(), NoteFilterCommand()] + self._commands = [ + NextCommand(self), PreviousCommand(self), JumpCommand(self), + GetCommand(self), IndexCommand(self), CurveListCommand(self), + NameCommand(self), SaveCommand(self), LoadCommand(self), + AddCommand(self), AddGlobCommand(self), + RemoveCommand(self), ApplyCommand(self), + FilterCommand(self), + ] # Define common or complicated arguments @@ -35,116 +58,202 @@ def current_playlist_callback(hooke, command, argument, value): PlaylistArgument = Argument( name='playlist', type='playlist', callback=current_playlist_callback, help=""" -:class:`hooke.plugin.playlist.Playlist` to act on. Defaults to the -current playlist. +:class:`hooke.playlist.Playlist` to act on. Defaults to the current +playlist. """.strip()) def playlist_name_callback(hooke, command, argument, value): - return hooke.playlists.free_name() + if value != None: + return value + i = 0 + names = [p.name for p in hooke.playlists] + while True: + name = 'playlist-%d' % i + if name not in names: + return name + i += 1 PlaylistNameArgument = Argument( - name='name', type='string', optional=True, callback=playlist_name_callback, + name='output playlist', type='string', optional=True, + callback=playlist_name_callback, help=""" Name of the new playlist (defaults to an auto-generated name). """.strip()) +def all_drivers_callback(hooke, command, argument, value): + return hooke.drivers + + +# Define useful command subclasses + +class PlaylistCommand (Command): + """A :class:`~hooke.command.Command` operating on a + :class:`~hooke.playlist.Playlist`. + """ + def __init__(self, **kwargs): + if 'arguments' in kwargs: + kwargs['arguments'].insert(0, PlaylistArgument) + else: + kwargs['arguments'] = [PlaylistArgument] + super(PlaylistCommand, self).__init__(**kwargs) + + def _playlist(self, hooke, params): + """Get the selected playlist. + + Notes + ----- + `hooke` is intended to attach the selected playlist to the + local hooke instance; the returned playlist should not be + effected by the state of `hooke`. + """ + # HACK? rely on params['playlist'] being bound to the local + # hooke (i.e. not a copy, as you would get by passing a + # playlist through the queue). Ugh. Stupid queues. As an + # alternative, we could pass lookup information through the + # queue... + return params['playlist'] + + +class PlaylistAddingCommand (Command): + """A :class:`~hooke.command.Command` adding a + :class:`~hooke.playlist.Playlist`. + """ + def __init__(self, **kwargs): + if 'arguments' in kwargs: + kwargs['arguments'].insert(0, PlaylistNameArgument) + else: + kwargs['arguments'] = [PlaylistNameArgument] + super(PlaylistAddingCommand, self).__init__(**kwargs) + + def _set_playlist(self, hooke, params, playlist): + """Attach a new playlist. + """ + playlist_names = [p.name for p in hooke.playlists] + if playlist.name in playlist_names or playlist.name == None: + playlist.name = params['output playlist'] # HACK: override input name. How to tell if it is callback-generated? + hooke.playlists.append(playlist) + # Define commands -class NextCommand (Command): +class NextCommand (PlaylistCommand): """Move playlist to the next curve. """ - def __init__(self): + def __init__(self, plugin): super(NextCommand, self).__init__( - name='next curve', - arguments=[PlaylistArgument], - help=self.__doc__) + name='next curve', help=self.__doc__, plugin=plugin) def _run(self, hooke, inqueue, outqueue, params): - params['playlist'].next() + self._playlist(hooke, params).next() -class PreviousCommand (Command): + +class PreviousCommand (PlaylistCommand): """Move playlist to the previous curve. """ - def __init__(self): + def __init__(self, plugin): super(PreviousCommand, self).__init__( - name='previous curve', - arguments=[PlaylistArgument], - help=self.__doc__) + name='previous curve', help=self.__doc__, plugin=plugin) def _run(self, hooke, inqueue, outqueue, params): - params['playlist'].previous() + self._playlist(hooke, params).previous() -class JumpCommand (Command): + +class JumpCommand (PlaylistCommand): """Move playlist to a given curve. """ - def __init__(self): + def __init__(self, plugin): super(JumpCommand, self).__init__( name='jump to curve', arguments=[ - PlaylistArgument, Argument(name='index', type='int', optional=False, help=""" Index of target curve. """.strip()), ], - help=self.__doc__) + help=self.__doc__, plugin=plugin) def _run(self, hooke, inqueue, outqueue, params): - params['playlist'].jump(params['index']) + self._playlist(hooke, params).jump(params['index']) -class IndexCommand (Command): + +class IndexCommand (PlaylistCommand): """Print the index of the current curve. The first curve has index 0. """ - def __init__(self): + def __init__(self, plugin): super(IndexCommand, self).__init__( - name='curve index', - arguments=[ - PlaylistArgument, - ], - help=self.__doc__) + name='curve index', help=self.__doc__, plugin=plugin) + + def _run(self, hooke, inqueue, outqueue, params): + outqueue.put(self._playlist(hooke, params).index()) + + +class GetCommand (PlaylistCommand): + """Return a :class:`hooke.playlist.Playlist`. + """ + def __init__(self, plugin): + super(GetCommand, self).__init__( + name='get playlist', help=self.__doc__, plugin=plugin) def _run(self, hooke, inqueue, outqueue, params): - outqueue.put(params['playlist']._index) + outqueue.put(self._playlist(hooke, params)) + -class CurveListCommand (Command): +class CurveListCommand (PlaylistCommand): """Get the curves in a playlist. """ - def __init__(self): + def __init__(self, plugin): super(CurveListCommand, self).__init__( - name='playlist curves', + name='playlist curves', help=self.__doc__, plugin=plugin) + + def _run(self, hooke, inqueue, outqueue, params): + outqueue.put(list(self._playlist(hooke, params))) + + +class NameCommand (PlaylistCommand): + """(Re)name a playlist. + """ + def __init__(self, plugin): + super(NameCommand, self).__init__( + name='name playlist', arguments=[ - PlaylistArgument, + Argument(name='name', type='string', optional=False, + help=""" +Name for the playlist. +""".strip()), ], - help=self.__doc__) + help=self.__doc__, plugin=plugin) def _run(self, hooke, inqueue, outqueue, params): - outqueue.put([c for c in params['playlist']]) + p = self._playlist(hooke, params) + p.name = params['name'] + outqueue.put(p) + -class SaveCommand (Command): +class SaveCommand (PlaylistCommand): """Save a playlist. """ - def __init__(self): + def __init__(self, plugin): super(SaveCommand, self).__init__( name='save playlist', arguments=[ - PlaylistArgument, Argument(name='output', type='file', help=""" File name for the output playlist. Defaults to overwriting the input -playlist. +playlist. If the playlist does not have an input file (e.g. it was +created from scratch with 'new playlist'), this option is required. """.strip()), ], - help=self.__doc__) + help=self.__doc__, plugin=plugin) def _run(self, hooke, inqueue, outqueue, params): - params['playlist'].save(params['output']) + self._playlist(hooke, params).save(params['output']) + -class LoadCommand (Command): +class LoadCommand (PlaylistAddingCommand): """Load a playlist. """ - def __init__(self): + def __init__(self, plugin): super(LoadCommand, self).__init__( name='load playlist', arguments=[ @@ -152,28 +261,27 @@ class LoadCommand (Command): help=""" File name for the input playlist. """.strip()), - Argument(name='drivers', type='driver', optional=False, - count=-1, + Argument(name='drivers', type='driver', optional=True, + count=-1, callback=all_drivers_callback, help=""" Drivers for loading curves. """.strip()), ], - help=self.__doc__) + help=self.__doc__, plugin=plugin) def _run(self, hooke, inqueue, outqueue, params): - p = FilePlaylist(drivers=params['drivers'], path=params['input']) - p.load() - hooke.playlists.append(p) + p = load(path=params['input'], drivers=params['drivers'], hooke=hooke) + self._set_playlist(hooke, params, p) outqueue.put(p) -class AddCommand (Command): + +class AddCommand (PlaylistCommand): """Add a curve to a playlist. """ - def __init__(self): + def __init__(self, plugin): super(AddCommand, self).__init__( name='add curve to playlist', arguments=[ - PlaylistArgument, Argument(name='input', type='file', optional=False, help=""" File name for the input :class:`hooke.curve.Curve`. @@ -183,25 +291,25 @@ File name for the input :class:`hooke.curve.Curve`. Additional information for the input :class:`hooke.curve.Curve`. """.strip()), ], - help=self.__doc__) + help=self.__doc__, plugin=plugin) def _run(self, hooke, inqueue, outqueue, params): - params['playlist'].append_curve_by_path(params['input'], - params['info']) + self._playlist(hooke, params).append_curve_by_path( + params['input'], params['info'], hooke=hooke) + -class AddGlobCommand (Command): +class AddGlobCommand (PlaylistCommand): """Add curves to a playlist with file globbing. Adding lots of files one at a time can be tedious. With this command you can use globs (`data/curves/*.dat`) to add curves for all matching files at once. """ - def __init__(self): + def __init__(self, plugin): super(AddGlobCommand, self).__init__( name='glob curves to playlist', arguments=[ - PlaylistArgument, - Argument(name='input', type='glob', optional=False, + Argument(name='input', type='string', optional=False, help=""" File name glob for the input :class:`hooke.curve.Curve`. """.strip()), @@ -210,65 +318,121 @@ File name glob for the input :class:`hooke.curve.Curve`. Additional information for the input :class:`hooke.curve.Curve`. """.strip()), ], - help=self.__doc__) + help=self.__doc__, plugin=plugin) def _run(self, hooke, inqueue, outqueue, params): + p = self._playlist(hooke, params) for path in sorted(glob.glob(params['input'])): - params['playlist'].append_curve_by_path(path, params['info']) - -class RemoveCommand (Command): + try: + p.append_curve_by_path(path, params['info'], hooke=hooke) + except NotRecognized, e: + log = logging.getLogger('hooke') + log.warn(unicode(e)) + continue + outqueue.put(p[-1]) + +class RemoveCommand (PlaylistCommand): """Remove a curve from a playlist. """ - def __init__(self): + def __init__(self, plugin): super(RemoveCommand, self).__init__( name='remove curve from playlist', arguments=[ - PlaylistArgument, Argument(name='index', type='int', optional=False, help=""" Index of target curve. """.strip()), ], - help=self.__doc__) + help=self.__doc__, plugin=plugin) def _run(self, hooke, inqueue, outqueue, params): - params['playlist'].pop(params['index']) - params['playlist'].jump(params._index) + self._playlist(hooke, params).pop(params['index']) + self._playlist(hooke, params).jump(params.index()) -class FilterCommand (Command): - """Create a subset playlist via a selection function. - Removing lots of curves one at a time can be tedious. With this - command you can use a function `filter` to select the curves you - wish to keep. +class ApplyCommand (PlaylistCommand): + """Apply a :class:`~hooke.command_stack.CommandStack` to each + curve in a playlist. + + TODO: discuss `evaluate`. """ - def __init__(self): - super(FilterCommand, self).__init__( - name='filter playlist', + def __init__(self, plugin): + super(ApplyCommand, self).__init__( + name='apply command stack to playlist', arguments=[ - PlaylistArgument, - PlaylistNameArgument, - Argument(name='filter', type='function', optional=False, + Argument(name='commands', type='command stack', + help=""" +Command stack to apply to each curve. Defaults to the `command_stack` +plugin's current stack. +""".strip()), + Argument(name='evaluate', type='bool', default=False, help=""" -Function returning `True` for "good" curves. `filter(curve) -> True/False`. +Evaluate the applied command stack immediately. """.strip()), ], - help=self.__doc__) + help=self.__doc__, plugin=plugin) def _run(self, hooke, inqueue, outqueue, params): - p = params['playlist'].filter(params['filter']) - hooke.playlists.add(p) - outqueue.put(p) + params = self.__setup_params(hooke=hooke, params=params) + p = self._playlist(hooke, params) + if params['evaluate'] == True: + exec_cmd = hooke.command_by_name['execute command stack'] + for curve in p.items(): + hooke.run_command(exec_cmd.name, + {'commands':params['commands'], + 'stack':True}) + else: + for curve in p: + for command in params['commands']: + curve.command_stack.append(command) + curve.set_hooke(hooke) + p.unload(curve) + + def __setup_params(self, hooke, params): + if params['commands'] == None: + cstack_plugin = [p for p in hooke.plugins + if p.name == 'command_stack'][0] + params['commands'] = cstack_plugin.command_stack + return params + + +class FilterCommand (PlaylistAddingCommand, PlaylistCommand): + """Create a subset playlist via a selection function. + + Removing lots of curves one at a time can be tedious. With this + command you can use a function `filter` to select the curves you + wish to keep. -class NoteFilterCommand (FilterCommand): - """Create a subset playlist of curves with `.info['note'] != None`. + Notes + ----- + There are issues with pickling functions bound to class + attributes, because the pickle module doesn't know where those + functions were originally defined (where it should point the + loader). Because of this, subclasses with hard-coded filter + functions are encouraged to define their filter function as a + method of their subclass. See, for example, + :meth:`NoteFilterCommand.filter`. """ - def __init__(self): - super(NoteFilterCommand, self).__init__() - self.name = 'note filter playlist' - self.arguments = [a for a in self.arguments if a.name != 'filter'] + def __init__(self, plugin, name='filter playlist', load_curves=True): + super(FilterCommand, self).__init__( + name=name, help=self.__doc__, plugin=plugin) + self._load_curves = load_curves + if not hasattr(self, 'filter'): + self.arguments.append( + Argument(name='filter', type='function', optional=False, + help=""" +Function returning `True` for "good" curves. +`filter(curve, hooke, inqueue, outqueue, params) -> True/False`. +""".strip())) def _run(self, hooke, inqueue, outqueue, params): - params['filter'] = lambda curve : \ - 'note' in curve.info and curve.info['note'] != None - return super(NoteFilterCommand, self)._run( - hooke, inqueue, outqueue, params) + if not hasattr(self, 'filter'): + filter_fn = params['filter'] + else: + filter_fn = self.filter + p = self._playlist(hooke, params).filter( + filter_fn, load_curves=self._load_curves, + hooke=hooke, inqueue=inqueue, outqueue=outqueue, params=params) + self._set_playlist(hooke, params, p) + if hasattr(p, 'path') and p.path != None: + p.set_path(os.path.join(os.path.dirname(p.path), p.name)) + outqueue.put(p)