/usr/share/pyshared/quodlibet/plugins/editing.py is in exfalso 2.3.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 | # -*- coding: utf-8 -*-
# Copyright 2005 Joe Wreschnig
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License version 2 as
# published by the Free Software Foundation
import gtk
from quodlibet.plugins import Manager
class RenameFilesPlugin(object):
"""Plugins of this type must subclass a GTK widget. They will be
packed into the RenameFiles pane (currently a ScrolledWindow hidden
with an expander, but that might change).
The 'filter' function will be called with the song's original filename
as a string (probably in the local filesystem encoding) and the proposed
new filename as a unicode object. It should return an
appropriate-transformed filename, still as a unicode object.
The plugin must provide either a 'changed' or 'preview'. 'preview'
causes the entire display to be re-previewed. 'changed' causes the
Preview button to made sensitive, and Save to be disabled.
If the 'active' attribute is false, the filter will not be called.
This is particularly useful for gtk.CheckButtons.
The '_order' attribute decides the sort order of the plugin. The
default filters have orders between 1 and 2. Plugins have order 0 by
default. Plugins with equal orders are sorted by class name."""
_order = 0.0
active = False
def filter(self, original_filename, value): return value
def filter_list(self, origs, names): return map(self.filter, origs, names)
def __cmp__(self, other):
return (cmp(self._order, other._order) or
cmp(type(self).__name__, type(other).__name__))
class TagsFromPathPlugin(object):
"""Plugins of this type must subclass a GTK widget. They will be
packed into the TagsFromPath pane (currently a ScrolledWindow hidden
with an expander, but that might change).
The 'filter' function will be called with the tag and proposed value
as a unicode object. It should return an appropriate-transformed
filename, still as a unicode object.
If you need to work on a set of filenames at once, you should
instead overload the 'filter_list' function, which takes two lists;
one of original filenames, the other of proposed new filenames.
The default filter_list function calls filter on each item.
The plugin must provide either a 'changed' or 'preview'. 'preview'
causes the entire display to be re-previewed. 'changed' causes the
Preview button to made sensitive, and Save to be disabled.
If the 'active' attribute is false, the filter will not be called.
This is particularly useful for gtk.CheckButtons.
The '_order' attribute decides the sort order of the plugin. The
default filters have orders between 1 and 2. Plugins have order 0 by
default. Plugins with equal orders are sorted by class name."""
_order = 0
active = False
def filter(self, tag, value): return value
def __cmp__(self, other):
return (cmp(self._order, other._order) or
cmp(type(self).__name__, type(other).__name__))
class EditTagsPlugin(gtk.ImageMenuItem):
"""Plugins of this type are subclasses of gtk.ImageMenuItem.
They will be added to the context menu of the EditTags tree view.
The 'tags' attribute is a list of tags this plugin should appear on,
or false if it should appear for all tags. This must be a class
attribute, as it is checked before instantiation.
The 'needs' attribute is a list of tags that must be editable in
the currently selected songs for the plugin to be sensitive.
The constructor is called with the tag and value for that row. This
can be used to set the sensitivity of the menu item, or change its
text.
When clicked, the 'activated' function is called on the object,
again with the tag name and value. It should return a list of
(tag, value) tuples to replace the previous tag/value with.
The '_order' attribute decides the sort order of the plugin. The
default items have orders between 0 and 1. Plugins have order 2.0 by
default. Plugins with equal orders are sorted by class name.
How to Handle Submenus
----------------------
If the menu item is given a submenu, magic happens. In particular,
the callbacks are proxied to the submenu's items, and are attached,
via connect_object, to make sure activated is called on the original
item.
So, to handle submenus,
1. Make a submenu and attach it to your menu item.2
2. To each item in the submenu, attach its 'activate' signal to
something appropriate to prepare the original item's
activated method,
3. Because that method will be called after the subitem is
clicked on, and your activate handler runs.
"""
tags = []
needs = []
_order = 2.0
def activated(self, tag, value): return [(tag, value)]
def connect(self, signal, callback, *args, **kwargs):
if self.get_submenu():
for item in self.get_submenu().get_children():
item.connect_object(signal, callback, self, *args, **kwargs)
else:
super(EditTagsPlugin, self).connect(
signal, callback, *args, **kwargs)
class EditingPlugins(Manager):
Kinds = [EditTagsPlugin, RenameFilesPlugin, TagsFromPathPlugin]
def RenamePlugins(self):
return super(EditingPlugins, self).find_subclasses(RenameFilesPlugin)
def TagsFromPathPlugins(self):
return super(EditingPlugins, self).find_subclasses(TagsFromPathPlugin)
def EditTagsPlugins(self):
return super(EditingPlugins, self).find_subclasses(EditTagsPlugin)
|