66 lines
2.0 KiB
Python
66 lines
2.0 KiB
Python
# blext
|
|
# Copyright (C) 2025 blext Project Contributors
|
|
#
|
|
# This program is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU Affero General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU Affero General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU Affero General Public License
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
"""Addon information deduced from the manifest and `bpy`."""
|
|
|
|
import tomllib
|
|
from pathlib import Path
|
|
|
|
import bpy
|
|
|
|
from .. import __package__ as base_package
|
|
|
|
PATH_ADDON_ROOT: Path = Path(__file__).resolve().parent.parent
|
|
PATH_MANIFEST: Path = PATH_ADDON_ROOT / 'blender_manifest.toml'
|
|
|
|
with PATH_MANIFEST.open('rb') as f:
|
|
MANIFEST = tomllib.load(f)
|
|
|
|
NAME: str = MANIFEST['id']
|
|
VERSION: str = MANIFEST['version']
|
|
|
|
|
|
####################
|
|
# - Dynamic Access
|
|
####################
|
|
def prefs() -> bpy.types.AddonPreferences | None:
|
|
"""Retrieve the preferences of this addon, if they are available yet.
|
|
|
|
Notes:
|
|
While registering the addon, one may wish to use the addon preferences.
|
|
This isn't possible - not even for default values.
|
|
|
|
Either a bad idea is at work, or `oscillode.utils.init_settings` should be consulted until the preferences are available.
|
|
|
|
Returns:
|
|
The addon preferences, if the addon is registered and loaded - otherwise None.
|
|
"""
|
|
addon = bpy.context.preferences.addons.get(base_package)
|
|
if addon is None:
|
|
return None
|
|
return addon.preferences
|
|
|
|
|
|
def addon_dir() -> Path:
|
|
"""Absolute path to a local addon-specific directory guaranteed to be writable."""
|
|
return Path(
|
|
bpy.utils.extension_path_user(
|
|
base_package,
|
|
path='',
|
|
create=True,
|
|
)
|
|
).resolve()
|