/usr/share/pyshared/quodlibet/plugins/songsmenu.py is in exfalso 3.0.2-3.
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 | # Copyright 2006 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
from gi.repository import Gtk
from quodlibet.util.songwrapper import check_wrapper_changed
class SongsMenuPlugin(Gtk.ImageMenuItem):
"""Plugins of this type are subclasses of Gtk.ImageMenuItem.
They will be added, in alphabetical order, to the "Plugins" menu
that appears when songs or lists of songs are right-clicked.
They provide one or more of the following instance methods:
self.plugin_single_song(song)
self.plugin_song(song)
self.plugin_songs(songs)
self.plugin_single_album(album)
self.plugin_album(album)
self.plugin_albums(albums)
All matching provided callables on a single object are called in the
above order if they match until one returns a true value. They are
not called with real AudioFile objects, but rather wrappers that
automatically detect metadata or disk changes, and save or reload
the files as appropriate. If the wrappers get changed after the above
methods return, call self.plugin_finish() to check for changes.
The single_ variant is only called if a single song/album is selected.
The singular tense is called once for each selected song/album, but the
plural tense is called with a list of songs/albums.
An album is a list of songs all with the same album, labelid,
and/or musicbrainz_albumid tags (like in the Album List).
To make your plugin insensitive if unsupported songs are selected,
a method that takes a list of songs and returns True or False to set
the sensitivity of the menu entry:
self.plugin_handles(songs)
When these functions are called, the self.plugin_window will be
available. This is the Gtk.Window the plugin was invoked from. This
provides access to two important widgets, self.plugin_window.browser
and self.plugin_window.songlist.
All of this is managed by the constructor for SongsMenuPlugin, so
make sure it gets called if you override it (you shouldn't have to).
"""
plugin_single_song = None
plugin_song = None
plugin_songs = None
plugin_single_album = None
plugin_album = None
plugin_albums = None
__initialized = False
def __init__(self, songs, library, window):
super(SongsMenuPlugin, self).__init__(self.PLUGIN_NAME)
self.__library = library
self.__songs = songs
self.plugin_window = window
self.__initialized = True
try:
i = Gtk.Image.new_from_stock(self.PLUGIN_ICON, Gtk.IconSize.MENU)
except AttributeError:
pass
else:
self.set_image(i)
self.set_sensitive(bool(self.plugin_handles(songs)))
@property
def initialized(self):
# If the GObject __init__ method is bypassed, it can cause segfaults.
# This explicitly prevents a bad plugin from taking down the app.
return self.__initialized
def plugin_handles(self, songs):
return True
def plugin_finish(self):
check_wrapper_changed(self.__library, self.plugin_window, self.__songs)
|