ModuleManager Class Reference

#include <ModuleManager.h>

Collaboration diagram for ModuleManager:

Public Member Functions
void	Initialize ()
int	Dispatch (ModuleDispatchTypes type)
bool	DiscoverProviders ()
auto	Providers () const
bool	RegisterEffectPlugin (const PluginID &provider, const PluginPath &path, TranslatableString &errMsg)
ModuleInterface *	CreateProviderInstance (const PluginID &provider, const PluginPath &path)
std::unique_ptr< ComponentInterface >	CreateInstance (const PluginID &provider, const PluginPath &path)
bool	IsProviderValid (const PluginID &provider, const PluginPath &path)
bool	IsPluginValid (const PluginID &provider, const PluginPath &path, bool bFast)

Static Public Member Functions
static ModuleManager &	Get ()
static wxString	GetPluginTypeString ()
static PluginID	GetID (ModuleInterface *module)

Private Types
using	DelayedErrors = std::vector< std::pair< std::unique_ptr< Module >, wxString > >

Private Member Functions
	ModuleManager ()
	~ModuleManager ()
	ModuleManager (const ModuleManager &) PROHIBITED
ModuleManager &	operator= (const ModuleManager &) PROHIBITED
void	InitializeBuiltins ()

Static Private Member Functions
static void	FindModules (FilePaths &files)
static void	TryLoadModules (const FilePaths &files, FilePaths &decided, DelayedErrors &errors)

Private Attributes
friend	ModuleInterfaceDeleter
ModuleMap	mDynModules
std::vector< std::unique_ptr< Module > >	mModules

Static Private Attributes
static std::unique_ptr< ModuleManager >	mInstance {}

Detailed Description

Definition at line 70 of file ModuleManager.h.

Member Typedef Documentation

DelayedErrors

using ModuleManager::DelayedErrors = std::vector< std::pair< std::unique_ptr<Module>, wxString > >

private

Definition at line 88 of file ModuleManager.h.

Constructor & Destructor Documentation

ModuleManager() [1/2]

ModuleManager::ModuleManager ( )

private

Definition at line 206 of file ModuleManager.cpp.

{
}

~ModuleManager()

ModuleManager::~ModuleManager ( )

private

Definition at line 210 of file ModuleManager.cpp.

{
   mDynModules.clear();
   builtinModuleList().clear();
}

References anonymous_namespace{ModuleManager.cpp}::builtinModuleList(), and mDynModules.

Here is the call graph for this function:

ModuleManager() [2/2]

ModuleManager::ModuleManager ( const ModuleManager &  )

private

Member Function Documentation

CreateInstance()

std::unique_ptr< ComponentInterface > ModuleManager::CreateInstance	(	const PluginID &	provider,
		const PluginPath &	path
	)

Definition at line 514 of file ModuleManager.cpp.

{
   if (auto iter = mDynModules.find(providerID);
       iter == mDynModules.end())
      return nullptr;
   else
      return iter->second->CreateInstance(path);
}

References mDynModules.

Referenced by PluginDescriptor::GetInstance().

Here is the caller graph for this function:

CreateProviderInstance()

ModuleInterface * ModuleManager::CreateProviderInstance	(	const PluginID &	provider,
		const PluginPath &	path
	)

Definition at line 503 of file ModuleManager.cpp.

{
   if (path.empty() && mDynModules.find(providerID) != mDynModules.end())
   {
      return mDynModules[providerID].get();
   }
 
   return nullptr;
}

References mDynModules.

Referenced by PluginManager::CheckForUpdates(), and PluginDescriptor::GetInstance().

Here is the caller graph for this function:

DiscoverProviders()

bool ModuleManager::DiscoverProviders

(

)

Definition at line 420 of file ModuleManager.cpp.

{
   InitializeBuiltins();
 
// The commented out code loads modules whether or not they are enabled.
// none of our modules is a 'provider' of effects, so this code commented out. 
#if 0
   FilePaths provList;
   FilePaths pathList;
 
   // Code from LoadLadspa that might be useful in load modules.
   wxString pathVar = wxString::FromUTF8(getenv("AUDACITY_MODULES_PATH"));
 
   if (!pathVar.empty())
   {
      FileNames::AddMultiPathsToPathList(pathVar, pathList);
   }
   else
   {
      FileNames::AddUniquePathToPathList(FileNames::ModulesDir(), pathList);
   }
 
#if defined(__WXMSW__)
   FileNames::FindFilesInPathList(wxT("*.dll"), pathList, provList);
#elif defined(__WXMAC__)
   FileNames::FindFilesInPathList(wxT("*.dylib"), pathList, provList);
#else
   FileNames::FindFilesInPathList(wxT("*.so"), pathList, provList);
#endif
 
   for ( const auto &path : provList )
      LoadModule(path);
#endif
 
   return true;
}

References FileNames::AddMultiPathsToPathList(), FileNames::AddUniquePathToPathList(), FileNames::FindFilesInPathList(), InitializeBuiltins(), and FileNames::ModulesDir().

Here is the call graph for this function:

Dispatch()

int ModuleManager::Dispatch

(

ModuleDispatchTypes

type

)

Definition at line 381 of file ModuleManager.cpp.

{
   for (const auto &module: mModules) {
      module->Dispatch(type);
   }
   return 0;
}

References mModules.

Referenced by AudacityApp::InitPart2(), ProjectManager::New(), ProjectManager::OnCloseWindow(), and QuitAudacity().

Here is the caller graph for this function:

FindModules()

void ModuleManager::FindModules ( FilePaths &  files )

staticprivate

Definition at line 217 of file ModuleManager.cpp.

{
   const auto &audacityPathList = FileNames::AudacityPathList();
   FilePaths pathList;
   wxString pathVar;
 
   // Code from LoadLadspa that might be useful in load modules.
   pathVar = wxGetenv(wxT("AUDACITY_MODULES_PATH"));
   if (!pathVar.empty())
      FileNames::AddMultiPathsToPathList(pathVar, pathList);
 
   for (const auto &path : audacityPathList) {
      wxString prefix = path + wxFILE_SEP_PATH;
      FileNames::AddUniquePathToPathList(prefix + wxT("modules"),
                                         pathList);
      if (files.size()) {
         break;
      }
   }
 
   #if defined(__WXMSW__)
   FileNames::FindFilesInPathList(wxT("*.dll"), pathList, files);
   #else
   FileNames::FindFilesInPathList(wxT("*.so"), pathList, files);
   #endif
}

References FileNames::AddMultiPathsToPathList(), FileNames::AddUniquePathToPathList(), FileNames::AudacityPathList(), and FileNames::FindFilesInPathList().

Referenced by Initialize().

Here is the call graph for this function:

Here is the caller graph for this function:

Get()

ModuleManager & ModuleManager::Get ( )

static

Definition at line 395 of file ModuleManager.cpp.

{
   if (!mInstance)
   {
      mInstance.reset(safenew ModuleManager);
   }
 
   return *mInstance;
}

References mInstance, and safenew.

Referenced by PluginManager::CheckForUpdates(), PluginManager::DropFile(), PluginDescriptor::GetInstance(), PluginManager::Initialize(), AudacityApp::InitPart2(), ProjectManager::New(), ProjectManager::OnCloseWindow(), PluginRegistrationDialog::OnOK(), QuitAudacity(), and TryLoadModules().

Here is the caller graph for this function:

GetID()

PluginID ModuleManager::GetID ( ModuleInterface *  module )

static

Definition at line 410 of file ModuleManager.cpp.

{
   return wxString::Format(wxT("%s_%s_%s_%s_%s"),
                           GetPluginTypeString(),
                           wxEmptyString,
                           module->GetVendor().Internal(),
                           module->GetSymbol().Internal(),
                           module->GetPath());
}

References ComponentInterface::GetPath(), GetPluginTypeString(), ComponentInterface::GetSymbol(), ComponentInterface::GetVendor(), and ComponentInterfaceSymbol::Internal().

Referenced by PluginManager::GetID(), and InitializeBuiltins().

Here is the call graph for this function:

Here is the caller graph for this function:

GetPluginTypeString()

wxString ModuleManager::GetPluginTypeString ( )

static

Definition at line 405 of file ModuleManager.cpp.

{
   return L"Module";
}

Referenced by GetID(), and PluginManager::GetPluginTypeString().

Here is the caller graph for this function:

Initialize()

void ModuleManager::Initialize

(

)

Definition at line 354 of file ModuleManager.cpp.

{
   FilePaths files;
   FindModules(files);
 
   FilePaths decided;
   DelayedErrors errors;
   size_t numDecided = 0;
 
   // Multiple passes give modules multiple chances to load in case they
   // depend on some other module not yet loaded
   do {
      numDecided = decided.size();
      errors.clear();
      TryLoadModules(files, decided, errors);
   }
   while ( errors.size() && numDecided < decided.size() );
 
   // Only now show accumulated errors of modules that failed to load
   for ( const auto &pair : errors ) {
      auto &pModule = pair.first;
      pModule->ShowLoadFailureError(pair.second);
      ModuleSettings::SetModuleStatus( pModule->GetName(), kModuleFailed );
   }
}

References FindModules(), kModuleFailed, ModuleSettings::SetModuleStatus(), and TryLoadModules().

Referenced by AudacityApp::InitPart2().

Here is the call graph for this function:

Here is the caller graph for this function:

InitializeBuiltins()

void ModuleManager::InitializeBuiltins ( )

private

Definition at line 457 of file ModuleManager.cpp.

{
   for (auto moduleMain : builtinModuleList())
   {
      ModuleInterfaceHandle module {
         moduleMain(), ModuleInterfaceDeleter{}
      };
 
      if (module && module->Initialize())
      {
         // Register the provider
         ModuleInterface *pInterface = module.get();
         auto id = GetID(pInterface);
 
         // Need to remember it 
         mDynModules[id] = std::move(module);
      }
      else
      {
         // Don't leak!  Destructor of module does that.
      }
   }
}

References anonymous_namespace{ModuleManager.cpp}::builtinModuleList(), GetID(), id, and mDynModules.

Referenced by DiscoverProviders().

Here is the call graph for this function:

Here is the caller graph for this function:

IsPluginValid()

bool ModuleManager::IsPluginValid	(	const PluginID &	provider,
		const PluginPath &	path,
		bool	bFast
	)

Definition at line 542 of file ModuleManager.cpp.

{
   if (mDynModules.find(providerID) == mDynModules.end())
   {
      return false;
   }
 
   return mDynModules[providerID]->IsPluginValid(path, bFast);
}

References mDynModules.

Referenced by PluginManager::CheckForUpdates().

Here is the caller graph for this function:

IsProviderValid()

bool ModuleManager::IsProviderValid	(	const PluginID &	provider,
		const PluginPath &	path
	)

Definition at line 524 of file ModuleManager.cpp.

{
   // Builtin modules do not have a path
   if (path.empty())
   {
      return true;  
   }
 
   wxFileName lib(path);
   if (lib.FileExists() || lib.DirExists())
   {
      return true;
   }
 
   return false;
}

Referenced by PluginManager::CheckForUpdates().

Here is the caller graph for this function:

operator=()

ModuleManager& ModuleManager::operator= ( const ModuleManager &  )

private

Providers()

auto ModuleManager::Providers ( ) const

inline

Definition at line 102 of file ModuleManager.h.

   { return make_iterator_range(mDynModules.cbegin(), mDynModules.cend()); }

References make_iterator_range().

Here is the call graph for this function:

RegisterEffectPlugin()

bool ModuleManager::RegisterEffectPlugin	(	const PluginID &	provider,
		const PluginPath &	path,
		TranslatableString &	errMsg
	)

Definition at line 490 of file ModuleManager.cpp.

{
   errMsg = {};
   if (mDynModules.find(providerID) == mDynModules.end())
   {
      return false;
   }
 
   auto nFound = mDynModules[providerID]->DiscoverPluginsAtPath(path, errMsg, PluginManagerInterface::DefaultRegistrationCallback);
 
   return nFound > 0;
}

References PluginManagerInterface::DefaultRegistrationCallback(), and mDynModules.

Referenced by PluginRegistrationDialog::OnOK().

Here is the call graph for this function:

Here is the caller graph for this function:

TryLoadModules()

void ModuleManager::TryLoadModules ( const FilePaths &  files, FilePaths &  decided, DelayedErrors &  errors  )

staticprivate

Definition at line 244 of file ModuleManager.cpp.

{
   FilePaths checked;
   wxString saveOldCWD = ::wxGetCwd();
   auto cleanup = finally([&]{ ::wxSetWorkingDirectory(saveOldCWD); });
   for (const auto &file : files) {
      // As a courtesy to some modules that might be bridges to
      // open other modules, we set the current working
      // directory to be the module's directory.
      auto prefix = ::wxPathOnly(file);
      ::wxSetWorkingDirectory(prefix);
 
      // Only process the first module encountered in the
      // defined search sequence.
      wxString ShortName = wxFileName( file ).GetName();
      if( checked.Index( ShortName, false ) != wxNOT_FOUND )
         continue;
      checked.Add( ShortName );
 
      // Skip if a previous pass through this function decided it already
      if( decided.Index( ShortName, false ) != wxNOT_FOUND )
         continue;
 
#ifdef EXPERIMENTAL_MODULE_PREFS
      int iModuleStatus = ModuleSettings::GetModuleStatus( file );
      if( iModuleStatus == kModuleDisabled )
         continue;
      if( iModuleStatus == kModuleFailed )
         continue;
      // New module?  You have to go and explicitly enable it.
      if( iModuleStatus == kModuleNew ){
         // To ensure it is noted in config file and so
         // appears on modules page.
         ModuleSettings::SetModuleStatus( file, kModuleNew);
         continue;
      }
 
      if( iModuleStatus == kModuleAsk )
#endif
      // JKC: I don't like prompting for the plug-ins individually
      // I think it would be better to show the module prefs page,
      // and let the user decide for each one.
      {
         auto msg = XO("Module \"%s\" found.").Format( ShortName );
         msg += XO("\n\nOnly use modules from trusted sources");
         const TranslatableStrings buttons{
            XO("Yes"), XO("No"),
         };  // could add a button here for 'yes and remember that', and put it into the cfg file.  Needs more thought.
         int action;
         action = ShowMultiDialog(msg, XO("Audacity Module Loader"),
            buttons,
            "",
            XO("Try and load this module?"),
            false);
#ifdef EXPERIMENTAL_MODULE_PREFS
         // If we're not prompting always, accept the answer permanently
         if( iModuleStatus == kModuleNew ){
            iModuleStatus = (action==1)?kModuleDisabled : kModuleEnabled;
            ModuleSettings::SetModuleStatus( file, iModuleStatus );
         }
#endif
         if(action == 1){   // "No"
            decided.Add( ShortName );
            continue;
         }
      }
#ifdef EXPERIMENTAL_MODULE_PREFS
      // Before attempting to load, we set the state to bad.
      // That way, if we crash, we won't try again.
      ModuleSettings::SetModuleStatus( file, kModuleFailed );
#endif
 
      wxString Error;
      auto umodule = std::make_unique<Module>(file);
         if (umodule->Load(Error))   // it will get rejected if there are version problems
      {
         decided.Add( ShortName );
         auto module = umodule.get();
 
         if (!module->HasDispatch())
         {
            auto ShortName = wxFileName(file).GetName();
            AudacityMessageBox(
               XO("The module \"%s\" does not provide any of the required functions.\n\nIt will not be loaded.").Format(ShortName),
               XO("Module Unsuitable"));
            wxLogMessage(wxT("The module \"%s\" does not provide any of the required functions. It will not be loaded."), file);
            module->Unload();
         }
         else
         {
            Get().mModules.push_back(std::move(umodule));
 
#ifdef EXPERIMENTAL_MODULE_PREFS
            // Loaded successfully, restore the status.
            ModuleSettings::SetModuleStatus(file, iModuleStatus);
#endif
         }
      }
      else if (!Error.empty()) {
         // Module is not yet decided in this pass.
         // Maybe it depends on another which has not yet been loaded.
         // But don't take the kModuleAsk path again in a later pass.
         ModuleSettings::SetModuleStatus( file, kModuleEnabled );
         errors.emplace_back( std::move( umodule ), Error );
      }
   }
}

References AudacityMessageBox(), Get(), ModuleSettings::GetModuleStatus(), kModuleAsk, kModuleDisabled, kModuleEnabled, kModuleFailed, kModuleNew, mModules, ModuleSettings::SetModuleStatus(), ShowMultiDialog(), and XO.

Referenced by Initialize().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

mDynModules

ModuleMap ModuleManager::mDynModules

private

Definition at line 133 of file ModuleManager.h.

Referenced by CreateInstance(), CreateProviderInstance(), InitializeBuiltins(), IsPluginValid(), RegisterEffectPlugin(), and ~ModuleManager().

mInstance

std::unique_ptr< ModuleManager > ModuleManager::mInstance {}

staticprivate

Definition at line 128 of file ModuleManager.h.

Referenced by Get().

mModules

std::vector<std::unique_ptr<Module> > ModuleManager::mModules

private

Definition at line 137 of file ModuleManager.h.

Referenced by Dispatch(), and TryLoadModules().

ModuleInterfaceDeleter

friend ModuleManager::ModuleInterfaceDeleter

private

Definition at line 126 of file ModuleManager.h.

---

The documentation for this class was generated from the following files:

• ModuleManager.h
• ModuleManager.cpp