API Reference

Core Modules

• Components
  • AudioComponent
  • Component
• Logic Management
  • Logic Class
  • Plugins Collection
• Tags & Categories
  • Category Management
  • MusicApps Database
  • Tagset Files

Defaults

Default paths for Logic Plugin Manager.

This module provides default filesystem paths used throughout the library for locating Audio Components and tag databases.

logic_plugin_manager.defaults.components_path: Path = PosixPath('/Library/Audio/Plug-Ins/Components')

Default location for macOS Audio Components (.component bundles).

Type:

Path

logic_plugin_manager.defaults.tags_path: Path = PosixPath('/home/docs/Music/Audio Music Apps/Databases/Tags')

Default location for Logic Pro’s tag and category database files.

Type:

Path

Exceptions

Exception classes for Logic Plugin Manager.

This module defines all custom exceptions used throughout the library for error handling related to plugin loading, tag management, and category operations.

exception logic_plugin_manager.exceptions.PluginLoadError

Bases: Exception

Base exception for errors occurring during plugin/component loading.

exception logic_plugin_manager.exceptions.NonexistentPlistError

Bases: PluginLoadError

Raised when a required Info.plist file cannot be found.

exception logic_plugin_manager.exceptions.CannotParsePlistError

Bases: PluginLoadError

Raised when a plist file exists but cannot be parsed or decoded.

exception logic_plugin_manager.exceptions.CannotParseComponentError

Bases: PluginLoadError

Raised when component data is malformed or cannot be extracted.

exception logic_plugin_manager.exceptions.OldComponentFormatError

Bases: PluginLoadError

Raised when a component uses a legacy format that is not supported.

exception logic_plugin_manager.exceptions.TagsetLoadError

Bases: Exception

Base exception for errors occurring during tagset operations.

exception logic_plugin_manager.exceptions.NonexistentTagsetError

Bases: TagsetLoadError

Raised when a .tagset file cannot be found at the expected path.

exception logic_plugin_manager.exceptions.CannotParseTagsetError

Bases: TagsetLoadError

Raised when a tagset file exists but cannot be parsed.

exception logic_plugin_manager.exceptions.TagsetWriteError

Bases: TagsetLoadError

Raised when writing to a tagset file fails.

exception logic_plugin_manager.exceptions.MusicAppsLoadError

Bases: Exception

Raised when MusicApps database files cannot be loaded or parsed.

exception logic_plugin_manager.exceptions.MusicAppsWriteError

Bases: Exception

Raised when writing to MusicApps database files fails.

exception logic_plugin_manager.exceptions.CategoryValidationError

Bases: Exception

Raised when a category name is invalid or not found in the database.

exception logic_plugin_manager.exceptions.CategoryExistsError

Bases: Exception

Raised when attempting to create a category that already exists.