Keep Playlist._loaded up to date on Curve.unload() calls.
[hooke.git] / hooke / plugin / playlist.py
index 73fd5a3ec04e0a388fbdb4d75e1587c109a217a0..43978b5669f7eba4f58fbb43241fa2dbb6090309 100644 (file)
@@ -22,11 +22,14 @@ several associated :class:`hooke.command.Command`\s for handling
 """
 
 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):
@@ -35,9 +38,11 @@ class PlaylistPlugin (Builtin):
         self._commands = [
             NextCommand(self), PreviousCommand(self), JumpCommand(self),
             GetCommand(self), IndexCommand(self), CurveListCommand(self),
-            SaveCommand(self), LoadCommand(self),
+            NameCommand(self), SaveCommand(self), LoadCommand(self),
             AddCommand(self), AddGlobCommand(self),
-            RemoveCommand(self), FilterCommand(self), NoteFilterCommand(self)]
+            RemoveCommand(self), ApplyCommand(self),
+            FilterCommand(self),
+            ]
 
 
 # Define common or complicated arguments
@@ -58,6 +63,8 @@ playlist.
 """.strip())
 
 def playlist_name_callback(hooke, command, argument, value):
+    if value != None:
+        return value
     i = 0
     names = [p.name for p in hooke.playlists]
     while True:
@@ -67,7 +74,8 @@ def playlist_name_callback(hooke, command, argument, value):
         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())
@@ -76,40 +84,87 @@ 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, plugin):
         super(NextCommand, self).__init__(
-            name='next curve',
-            arguments=[PlaylistArgument],
-            help=self.__doc__, plugin=plugin)
+            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, plugin):
         super(PreviousCommand, self).__init__(
-            name='previous curve',
-            arguments=[PlaylistArgument],
-            help=self.__doc__, plugin=plugin)
+            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, plugin):
         super(JumpCommand, self).__init__(
             name='jump to curve',
             arguments=[
-                PlaylistArgument,
                 Argument(name='index', type='int', optional=False, help="""
 Index of target curve.
 """.strip()),
@@ -117,68 +172,85 @@ Index of target curve.
             help=self.__doc__, plugin=plugin)
 
     def _run(self, hooke, inqueue, outqueue, params):
-       params['playlist'].jump(int(params['index'])) # HACK, int() should be handled by ui
+       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, plugin):
         super(IndexCommand, self).__init__(
-            name='curve index',
-            arguments=[
-                PlaylistArgument,
-                ],
-            help=self.__doc__, plugin=plugin)
+            name='curve index', help=self.__doc__, plugin=plugin)
 
     def _run(self, hooke, inqueue, outqueue, params):
-       outqueue.put(params['playlist'].index())
+       outqueue.put(self._playlist(hooke, params).index())
 
-class GetCommand (Command):
+
+class GetCommand (PlaylistCommand):
     """Return a :class:`hooke.playlist.Playlist`.
     """
     def __init__(self, plugin):
         super(GetCommand, self).__init__(
-            name='get playlist',
-            arguments=[PlaylistArgument],
-            help=self.__doc__, plugin=plugin)
+            name='get playlist', help=self.__doc__, plugin=plugin)
 
     def _run(self, hooke, inqueue, outqueue, params):
-        outqueue.put(params['playlist'])
+        outqueue.put(self._playlist(hooke, params))
 
-class CurveListCommand (Command):
+
+class CurveListCommand (PlaylistCommand):
     """Get the curves in a playlist.
     """
     def __init__(self, plugin):
         super(CurveListCommand, self).__init__(
-            name='playlist curves',
-            arguments=[PlaylistArgument],
+            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=[
+                Argument(name='name', type='string', optional=False,
+                         help="""
+Name for the playlist.
+""".strip()),
+                ],
             help=self.__doc__, plugin=plugin)
 
     def _run(self, hooke, inqueue, outqueue, params):
-       outqueue.put(list(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, 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__, 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, plugin):
@@ -198,19 +270,18 @@ Drivers for loading curves.
             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, 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`.
@@ -223,10 +294,11 @@ Additional information for the input :class:`hooke.curve.Curve`.
             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
@@ -237,7 +309,6 @@ class AddGlobCommand (Command):
         super(AddGlobCommand, self).__init__(
             name='glob curves to playlist',
             arguments=[
-                PlaylistArgument,
                 Argument(name='input', type='string', optional=False,
                          help="""
 File name glob for the input :class:`hooke.curve.Curve`.
@@ -250,17 +321,23 @@ Additional information for the input :class:`hooke.curve.Curve`.
             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, 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()),
@@ -268,10 +345,57 @@ Index of target curve.
             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 ApplyCommand (PlaylistCommand):
+    """Apply a :class:`~hooke.command_stack.CommandStack` to each
+    curve in a playlist.
+
+    TODO: discuss `evaluate`.
+    """
+    def __init__(self, plugin):
+        super(ApplyCommand, self).__init__(
+            name='apply command stack to playlist',
+            arguments=[
+                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="""
+Evaluate the applied command stack immediately.
+""".strip()),
+                ],
+            help=self.__doc__, plugin=plugin)
+
+    def _run(self, hooke, inqueue, outqueue, params):
+        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 (Command):
+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
@@ -288,14 +412,10 @@ class FilterCommand (Command):
     method of their subclass.  See, for example,
     :meth:`NoteFilterCommand.filter`.
     """
-    def __init__(self, plugin, name='filter playlist'):
+    def __init__(self, plugin, name='filter playlist', load_curves=True):
         super(FilterCommand, self).__init__(
-            name=name,
-            arguments=[
-                PlaylistArgument,
-                PlaylistNameArgument,
-                ],
-            help=self.__doc__, plugin=plugin)
+            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,
@@ -309,20 +429,10 @@ Function returning `True` for "good" curves.
             filter_fn = params['filter']
         else:
             filter_fn = self.filter
-        p = params['playlist'].filter(filter_fn,
+        p = self._playlist(hooke, params).filter(
+            filter_fn, load_curves=self._load_curves,
             hooke=hooke, inqueue=inqueue, outqueue=outqueue, params=params)
-        p.name = params['name']
+        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))
-        hooke.playlists.append(p)
         outqueue.put(p)
-
-class NoteFilterCommand (FilterCommand):
-    """Create a subset playlist of curves with `.info['note'] != None`.
-    """
-    def __init__(self, plugin):
-        super(NoteFilterCommand, self).__init__(
-            plugin, name='note filter playlist')
-
-    def filter(self, curve, hooke, inqueue, outqueue, params):
-        return 'note' in curve.info and curve.info['note'] != None