def list_plugins(workers=4):
""" List installed plugins.
Returns a list of plugin dicts with basic information about the plugin and
it's versions. Two additional fields exists in these dicts;
installed_version and installed_file.
"""
fields = ('slug,plugin_name,versions.hard_dependencies,versions.type,'
'versions.version,versions.download,versions.filename,'
'versions.md5,versions.slug')
plugins = parse_installed_plugins(workers)
if plugins == []:
return []
results = bukget.search(
{
'field': 'versions.checksum',
'action': 'in',
'value': [plugin[0] for plugin in plugins]
},
fields=fields)
if len(results) < len(plugins):
results += bukget.search(
{
'field': 'main',
'action': 'in',
'value': [plugin[1] for plugin in plugins]
},
fields=fields)
if len(results) < len(plugins):
results += bukget.search(
{
'field': 'plugin_name',
'action': 'in',
'value': [plugin[2] for plugin in plugins]
},
fields=fields)
results = utils.remove_duplicate_plugins(results)
for plugin in results:
i_plugin = None
for installed in plugins:
if installed[2] == plugin['plugin_name']:
plugin['installed_version'] = installed[3]
plugin['installed_file'] = installed[4]
i_plugin = installed
if i_plugin is not None:
plugins.remove(i_plugin)
return results
def search(query, size):
""" Search for plugins.
This function will search for plugins on bukget by their slug and name.
The results are ordered by a score calculated with their levenshtein edit
distance from the search query and their popularity.
Two parameters are required:
query The query to search for.
size The size of the returned results. It can be negative, and in
that case the bottom of the results are returned.
A list with the plugin dicts from BukGet is returned. It is sorted by the
score system mentioned earlier.
"""
sorting = ('-' if size >= 0 else '') + 'popularity.monthly'
search_results = bukget.search(
{
'field': 'plugin_name',
'action': 'like',
'value': query
},
sort=sorting,
fields='slug,plugin_name,description,popularity.monthly',
size=abs(size))
search_results += bukget.search(
{
'field': 'slug',
'action': 'like',
'value': query
},
sort=sorting,
fields='slug,plugin_name,description,popularity.monthly',
size=abs(size))
search_results = utils.remove_duplicate_plugins(search_results)
# Calculate scores
results = list()
for plugin in search_results:
score = plugin['popularity']['monthly']
distance = common.levenshtein(query, plugin['plugin_name'])
score -= distance
results.append((score, plugin))
results.sort(key=lambda x: x[0], reverse=True)
return [result[1] for result in results]
def dependencies(server, plugins, v_type='Latest', deps=True):
""" Resolve dependencies.
This function will return a list of plugin dictionaries of all plugins
depending directly, or indirectly on the plugins in `plugins`. `plugins`
may be a list of plugin slugs, or a single plugin slug.
"""
fields = ('slug,plugin_name,versions.hard_dependencies,versions.type,'
'versions.version,versions.download,versions.filename,'
'versions.md5')
if type(plugins) is not list:
plugins = [plugins]
plugins, versions = utils.extract_name_version(plugins)
results = bukget.search(
{
'field': 'plugin_name',
'action': 'in',
'value': plugins
},
fields=fields)
results += bukget.search(
{
'field': 'slug',
'action': 'in',
'value': plugins
}, fields=fields)
plugins = utils.remove_duplicate_plugins(results)
for plugin in plugins:
if not plugin['plugin_name'].lower() in versions:
continue
version = versions[plugin['plugin_name'].lower()]
for ver in plugin['versions']:
if ver['version'] == version:
plugin['versions'] = [ver]
break
else:
plugin['versions'] = []
if deps:
return _dependencies(server, plugins, v_type=v_type)
else:
return plugins
