path: root/os-plugins/OpenSLX/OSPlugin/Roster.pm

# Copyright (c) 2006, 2007 - OpenSLX GmbH
#
# This program is free software distributed under the GPL version 2.
# See http://openslx.org/COPYING
#
# If you have any feedback please consult http://openslx.org/feedback and
# send your suggestions, praise, or complaints to feedback@openslx.org
#
# General information about OpenSLX can be found at http://openslx.org/
# -----------------------------------------------------------------------------
# OSPlugin::Roster.pm
#	- provides information about all available plugins
# -----------------------------------------------------------------------------
package OpenSLX::OSPlugin::Roster;

use strict;
use warnings;

use OpenSLX::Basics;
use Storable qw(dclone);

my %plugins;

=item C<getAvailablePlugins()>

Returns a hash that keys the names of available plugins to their info hash.

=cut

sub getAvailablePlugins
{
	my $class = shift;

	$class->_init() if !%plugins;

	my %pluginInfo;
	foreach my $pluginName (keys %plugins) {
		$pluginInfo{$pluginName} = $plugins{$pluginName}->getInfo();
	}
	return \%pluginInfo;
}

=item C<getPlugin()>

Returns an instance of the plugin with the given name

=cut

sub getPlugin
{
	my $class      = shift;
	my $pluginName = shift;

	$class->_init() if !%plugins;

	my $plugin = $plugins{$pluginName};
	return if !$plugin;

	return dclone($plugin);
}

=item C<getPluginAttrInfo()>

Returns a hash that contains info about the attributes support by the 
given plugin

=cut

sub getPluginAttrInfo
{
	my $class      = shift;
	my $pluginName = shift;

	$class->_init() if !%plugins;

	return if !$plugins{$pluginName};

	return $plugins{$pluginName}->getAttrInfo();
}

=item C<addAllDefaultAttributesToHash()>

Fetches attribute info from all available plugins and adds it to the given
hash-ref.

=over

=item Return Value

1

=back

=cut

sub addAllDefaultAttributesToHash
{
	my $class    = shift;
	my $attrInfo = shift;

	$class->_init() if !%plugins;

	foreach my $plugin (values %plugins) {
		my $pluginAttrInfo = $plugin->getAttrInfo();
		foreach my $attr (keys %$pluginAttrInfo) {
			$attrInfo->{$attr} = $pluginAttrInfo->{$attr};
		}
	}
	return 1;
}

sub _init
{
	my $class = shift;

	%plugins = ();
	my $pluginPath = "$openslxConfig{'base-path'}/lib/plugins";
	foreach my $modulePath (glob("$pluginPath/*")) {
		next if $modulePath !~ m{/([^/]+)$};
		my $pluginName = $1;
		my $class = "OpenSLX::OSPlugin::$pluginName";
		vlog(2, "loading plugin $class from path '$modulePath'");
		my $plugin = instantiateClass($class, { pathToClass => $modulePath });
		$plugins{$pluginName} = $plugin;
	}
	return;
}

1;