pyfemtet 0.9.5__py3-none-any.whl → 1.0.0b0__py3-none-any.whl

pyfemtet/{_message → _i18n}/messages.py

@@ -1,38 +1,41 @@
-import os
-import locale
-from dataclasses import dataclass
+from .i18n import _
 
-loc, encoding = locale.getlocale()
 
-if __name__ == '__main__':
-    # set target to create .pot
-    from gettext import gettext as _
-
-else:
-    # get translation
-    if 'japanese' in loc.lower():
-        from babel.support import Translations
+class Message:
+    # rule
+    TEST = _('Hello!')
 
-        translations = Translations.load(
-            os.path.join(os.path.dirname(__file__), 'locales'),
-            locales='ja'
-        )
-        _ = translations.gettext
+    # ===== common =====
+    ENTER_TO_QUIT = _('Press enter to quit...')
+    CONSTRAINT = _('constraint')
+    HIDDEN_CONSTRAINT = _('hidden constraint')
 
-    else:
-        def _(x):
-            return x
+    # ===== pyfemtet.dispatch_extensions =====
+    WAIT_FOR_LAUNCH_FEMTET = _('Waiting for launch femtet...')
+    TRY_TO_CONNECT_FEMTET = _('Trying to connect Femtet...')
 
+    @staticmethod
+    def F_FEMTET_CONNECTED(pid):
+        return _(
+            'Successfully connected. The pid of Femtet is {pid}.',
+            pid=pid
+        )
 
-@dataclass
-class Message:
-    # syntax
-    HELLO = _('hello!')
-    # This is ignored by babel
-    def some_string(self, value): return _(f'value is {value}')
+    @staticmethod
+    def F_SEARCHING_FEMTET_WITH_SPECIFIC_PID(pid):
+        return _(
+            'Searching Femtet (pid = {pid}) ...',
+            pid=pid
+        )
 
-    # ===== common =====
-    ENTER_TO_QUIT = _('Press enter to quit...')
+    @staticmethod
+    def F_ERR_FEMTET_CONNECTION_TIMEOUT(pid, timeout):
+        return _(
+            'Connection to Femtet (pid = {pid}) was not'
+            'established in {timeout} sec',
+            pid=pid,
+            timeout=timeout,
+        )
 
     # ===== pyfemtet.opt femopt core =====
     ERR_CHECK_MINMAX = _('The magnitude relationship is incorrect.')
@@ -42,13 +45,12 @@ class Message:
 
     # ===== pyfemtet.opt FEMOpt =====
     ERR_NO_INITIAL_VALUE = _('Please specify initial_value.')
-    ERR_CONTAIN_GOGH_ACCESS_IN_STRICT_CONSTRAINT = _('Constraint functions are evaluated before analysis is performed, '
-                                                     'so do not access Femtet.Gogh. If you want your '
-                                                     'constraints to include values after analysis is performed, set '
-                                                     'the `strict` argument to False.')
-    WARN_HISTORY_CSV_NOT_ACCESSIBLE = _('History csv file is in use and cannot be written to. '
-                                        'Please free this file before exiting the program, '
-                                        'otherwise history data will be lost.')
+    ERR_CONTAIN_GOGH_ACCESS_IN_STRICT_CONSTRAINT = _(
+        'Constraint functions are evaluated before analysis is performed, '
+        'so do not access Femtet.Gogh. If you want your '
+        'constraints to include values after analysis is performed, set '
+        'the `strict` argument to False.')
+
     OPTIMIZATION_FINISHED = _('Optimization finished. Results were saved in following:')
     ERR_NO_BOUNDS = _('No bounds specified.')
     CONFIRM_BEFORE_EXIT = _('The optimization is now complete. You can view the results on the monitor until you press Enter to exit the program.')
@@ -59,8 +61,25 @@ class Message:
     ERR_MODEL_UPDATE_FAILED = _('Model update failed.')
     ERR_NO_MAKEPY = _('It was detected that the configuration of Femtet python macro constants has not been completed. The configuration was done automatically (python -m win32com.client.makepy FemtetMacro). Please restart the program. If the error persists, please run "py -m win32com.client.makepy FemtetMacro" or "python -m win32com.client.makepy FemtetMacro" on the command prompt.')
     ERR_FEMTET_CONNECTION_FAILED = _('Failed to connect to Femtet.')
-    ERR_FEMTET_CRASHED_AND_RESTART_FAILED = _('The Femtet process crashed and could not be restarted successfully.')
-    WARN_FEMTET_CRASHED_AND_TRY_RESTART = _('An abnormal termination of the Femtet process has been detected. Recovery will be attempted.')
+
+    @staticmethod
+    def F_ERR_FEMTET_CRASHED_AND_RESTART_FAILED(name):
+        return _(
+            'The Femtet process crashed and '
+            'Python failed to restore Femtet. '
+            'API: {name}',
+            name=name
+        )
+
+    @staticmethod
+    def F_WARN_FEMTET_CRASHED_AND_TRY_RESTART(name):
+        return _(
+            'An abnormal termination of the Femtet '
+            'process has been detected. Recovery will '
+            'be attempted. API: {name}',
+            name=name,
+        )
+
     INFO_FEMTET_CRASHED_AND_RESTARTED = _('Femtet has been restarted and will perform analysis and attempt to recover.')
     ERR_NEW_FEMTET_BUT_NO_FEMPRJ = _("If you specify 'new' as the 'connect_method' argument, set the 'femprj_path' argument to existing femprj file path.")
     ERR_NO_SUCH_PARAMETER_IN_FEMTET = _('The specified variable is not included in the Femtet analysis model. Note the capitalization of the variable.')
@@ -75,7 +94,7 @@ class Message:
     ERR_MODEL_MESH_FAILED = _('Mesh generation failed')
     ERR_PARAMETRIC_SOLVE_FAILED = _('Parametric solve failed')
     ERR_SOLVE_FAILED = _('Solve failed.')
-    ERR_OPEN_RESULT_FAILED = _('Open result failed.')
+    ERR_OPEN_RESULT_FAILED = _('Failed to open result.')
     ERR_CLOSE_FEMTET_FAILED = _('Failed to close Femtet.')
     ERR_FAILED_TO_SAVE_PDT = _('Failed to save result (.pdt) file.')
     ERR_FAILED_TO_SAVE_JPG = _('Failed to save screenshot (.jpg).')
@@ -100,6 +119,77 @@ class Message:
     START_CANDIDATE_WITH_PARAMETER_CONSTRAINT = _('Start to candidate new parameter set with constraints. This process may take a long time.')
     WARN_UPDATE_FEM_PARAMETER_TOOK_A_LONG_TIME = _('Updating FEM parameter during evaluating constraints take a long time. Please consider not to use FEM variables in constraint functions and set `update_fem` to False.')
 
+    # ===== optuna optimizer =====
+    @staticmethod
+    def F_WARN_INVALID_ARG_FOR_SAMPLER(key, sampler_name):
+        return _(
+            'The given argument {key} is not '
+            'included in ones of {sampler_name}. '
+            '{key} is ignored.',
+            key=key, sampler_name=sampler_name,
+        )
+
+    # ===== scipy optimizer =====
+    WARN_SCIPY_NELDER_MEAD_BOUND = _(
+        'Sometimes Nelder-Mead cannot start optimization '
+        'with the initial condition what is same with '
+        'lower bounds or upper bounds.'
+    )
+    ERR_SCIPY_NOT_IMPLEMENT_CATEGORICAL = _(
+        'Cannot use categorical parameter with ScipyOptimizer'
+    )
+    ERR_SCIPY_HARD_CONSTRAINT_VIOLATION = _(
+        en_message='Hard constraint violation! scipy cannot continue '
+                   'optimization. Only `SLSQP` supports optimization '
+                   'with hard constraint optimization problem. '
+                   'If you see this message even if you are using it, '
+                   'please try to following:\n'
+                   '- Use small `eps` by `options` argument.\n'
+                   '- Set `constraint_enhancement`to the value that '
+                   'it larger than the variation of the constraint '
+                   'function when input variables within the range '
+                   'of `eps`.',
+        jp_message='hard constraint を扱うには'
+                   'method に SLSQP を使用してください。'
+                   'SLSQP を使用しているのにこのメッセージが表示される場合、\n'
+                   '- options から eps を小さくするか、'
+                   '- eps の値の範囲内で x が変動したときの'
+                   '拘束関数の変動量を上回るように'
+                   'constraint_enhancement を大きく\n'
+                   'してみてください。',
+    )
+    ERR_SCIPY_HIDDEN_CONSTRAINT = _(
+        en_message='ScipyOptimizer cannot continue optimization '
+                   'when encountered the input variables that '
+                   'break FEM model.',
+        jp_message='ScipyOptimizer では解析ができない'
+                   '設計変数の組合せをスキップできません。'
+    )
+    ERR_SCIPY_NOT_IMPLEMENT_SKIP = _('ScipyOptimizer cannot skip solve.')
+
+    @staticmethod
+    def F_ERR_SCIPY_METHOD_NOT_IMPLEMENT_HARD_CONSTRAINT(method):
+        return _('{method} cannot handle hard constraint.', method=method)
+
+    WARN_SCIPY_SLSQP_CANNOT_PROCESS_SOFT_CONSTRAINT = _(
+        'SLSQP cannot handle soft constraint. '
+        'The constraint is handled as a hard one.'
+    )
+
+    # ===== PoFBoTorchSampler =====
+    WARN_USING_FEM_IN_NLC = _(
+        'Accessing FEM API inside hard constraint '
+        'function may be very slow.')
+    WARN_NO_FEASIBLE_BATCH_INITIAL_CONDITION = _(
+        'gen_batch_initial_conditions() failed to generate '
+        'feasible initial conditions for acquisition '
+        'function optimization sub-problem, '
+        'so trying to use random feasible parameters '
+        'as initial conditions.'
+        'The constraint functions or solutions spaces '
+        'may be too complicated.'
+    )
+
     # ===== pyfemtet.opt.visualization =====
     # control_femtet.py
     LABEL_CONNECT_FEMTET_BUTTON = _('Connect to Femtet')
@@ -166,9 +256,6 @@ class Message:
                           'the `save_pdt` argument of FemtetInterface in optimization script'
                           '(default to `all`).')
     ERR_FAILED_TO_OPEN_PREFIX = _('Failed to open ')
-    ERR_NO_SUCH_MODEL_IN_FEMPRJ = _('Specified model is not in current project. '
-                                    'Please check opened project. '
-                                    'For example, not "analysis model only" but your .femprj file.')
     WARN_INCONSISTENT_FEMPRJ_PATH = _('.femprj file path of the history csv is invalid. Please certify matching between csv and opening .femprj file.')
     WARN_INVALID_MODEL_NAME = _('Analysis model name of the history csv is invalid. Please certify matching between csv and opening analysis model.')
     WARN_INCONSISTENT_MODEL_NAME = _('Analysis model name of the history csv and opened in Femtet is inconsistent. Please certify matching between csv and opening analysis model.')

pyfemtet/_util/closing.py

@@ -0,0 +1,19 @@
+import sys
+from traceback import print_tb
+
+__all__ = ['closing']
+
+
+class closing:
+    def __init__(self, thing):
+        self.thing = thing
+
+    def __enter__(self):
+        return self.thing
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        if exc_type is not None:
+            print(f'===== An exception is raised. Try to close resource. ===== ', file=sys.stderr)
+            print_tb(exc_tb)
+            print(f'{exc_type.__name__}: {exc_val}', file=sys.stderr)
+        self.thing.close()

pyfemtet/_util/dask_util.py

@@ -1,10 +1,92 @@
-from contextlib import nullcontext
-from dask.distributed import Lock
+import warnings
+from packaging.version import Version
+from threading import Lock as _ThreadingLock
 
+import dask
+from dask.distributed import LocalCluster, Client, Lock as _DaskLock, Nanny
+from dask.distributed import get_client as _get_client, get_worker as _get_worker
+from dask import config as cfg
+
+from pyfemtet.logger import get_dask_logger, remove_all_output, get_module_logger
+
+if Version(dask.__version__) < Version('2024.12.1'):
+    import pyfemtet
+    raise RuntimeError(
+        f'pyfemtet {pyfemtet.__version__} requires dask >= 2024.12.1, '
+        f'but the existing dask == {dask.__version__}. '
+        f'Please consider to update dask.\n'
+        f'ex: `py -m pip install dask distributed`'
+    )
+
+remove_all_output(get_dask_logger())
+
+warnings.filterwarnings('ignore', category=RuntimeWarning, message="Couldn't detect a suitable IP address")
+
+cfg.set({'distributed.scheduler.worker-ttl': None})
+
+logger = get_module_logger('opt.dask', False)
+
+
+__all__ = [
+    'get_client',
+    'get_worker',
+    'Lock',
+    'LocalCluster',
+    'Client',
+    'Nanny',
+    'DummyClient',
+]
+
+_lock_pool = {}
+
+
+def get_client():
+    try:
+        return _get_client()
+    except ValueError:
+        return None
+
+
+def get_worker():
+    try:
+        return _get_worker()
+    except ValueError:
+        return None
+
+
+def Lock(name, client=None):
+    global _lock_pool
+
+    if client is None:
+        client = get_client()
+
+    if client is not None:
+        # import inspect
+        # logger.debug(f'{name}, {[stack.function for stack in inspect.stack()[1:]]}')
+        with cfg.set({"distributed.scheduler.locks.lease-timeout": "inf"}):
+            _lock = _DaskLock(name)
 
-def lock_or_no_lock(name: str, client=None):
-    lock = Lock(name, client)
-    if lock.client is None:
-        return nullcontext()
     else:
-        return lock
+        if name in _lock_pool:
+            _lock = _lock_pool[name]
+        else:
+            _lock = _ThreadingLock()
+            _lock_pool.update({name: _lock})
+
+    return _lock
+
+
+class DummyClient:
+
+    @staticmethod
+    def scheduler_info():
+        return dict(workers=dict())
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        pass
+
+    def map(self, *args, **kwargs): ...
+    def gather(self, *args, **kwargs): ...

pyfemtet/_util/df_util.py

@@ -0,0 +1,29 @@
+import pandas as pd
+
+
+__all__ = [
+    'apply_partial_df',
+    'get_partial_df',
+]
+
+
+def get_index(df, equality_filters):
+    # フィルタ条件に一致する行のインデックスを取得
+    # noinspection PyUnresolvedReferences
+    return (df[list(equality_filters.keys())] == pd.Series(equality_filters)).all(axis=1)
+
+
+def get_partial_df(df: pd.DataFrame, equality_filters: dict):
+    return df[get_index(df, equality_filters)]
+
+
+def apply_partial_df(df: pd.DataFrame, partial_df: pd.DataFrame, equality_filters: dict):
+
+    idx = get_index(df, equality_filters)
+
+    # インデクスに対応する部分を上書き
+    assert len(df[idx]) == len(partial_df), ('equality_filters の実行結果と'
+                                             '与えられた partial_df の長さが一致しません。')
+    df[idx] = partial_df
+
+    return df

pyfemtet/_util/excel_macro_util.py

@@ -9,7 +9,13 @@ import win32process
 
 from pyfemtet.logger import get_module_logger
 
-logger = get_module_logger('util.excel', __name__)
+
+__all__ = [
+    'watch_excel_macro_error'
+]
+
+
+logger = get_module_logger('util.excel', False)
 
 
 def _get_pid(hwnd):
@@ -152,7 +158,6 @@ def watch_excel_macro_error(excel_, timeout, restore_book=True):
     return _ExcelDialogProcessor(excel_, timeout, restore_book)
 
 
-
 if __name__ == '__main__':
 
     import os
@@ -161,8 +166,8 @@ if __name__ == '__main__':
     path = os.path.abspath('sample.xlsm')
     path2 = os.path.abspath('sample2.xlsm')
 
-
     from win32com.client import Dispatch
+    # noinspection PyUnresolvedReferences
     from pythoncom import com_error
 
     logger.debug('Excel を起動しています。')

pyfemtet/_util/excel_parse_util.py

@@ -2,8 +2,11 @@ import os
 import numpy as np
 import pandas as pd
 
+from pyfemtet.opt.history._history import ColumnManager  # to use _reconvert
+
 
 __all__ = [
+    '_EMPTY_CHOICE',
     'ParseAsParameter',
     'ParseAsConstraint',
     'ParseAsObjective',
@@ -13,15 +16,18 @@ __all__ = [
 ]
 
 
-def parse_excel(book_path, sheet_name, keyword, required, optional, raise_if_no_keyword=True) -> pd.DataFrame:
+_EMPTY_CHOICE = ''
+
+
+def parse_excel(book_path, sheet_name, keyword, required, optional, raise_if_no_keyword) -> pd.DataFrame:
     """Excel シートからパラメータを取得します。
 
     シートのパースプロセスは以下の通りです。
 
     1. シート全体 (A1 セルから、値が入力されている最終セルまで) をデータに取り込みます。
-    2. 最も左上（上が優先）にある keyword に一致するセルより上および左の行・列をデータから除きます。
-    3. その時点のデータの上から順に見てすべてのセルが空白である行以下の行をデータから除きます。
-    4. すべてのセルが空白である列をデータから除きます。
+    2. すべてのセルが空白である列をデータから除きます。
+    3. すべてのセルが空白である行をデータから除きます。
+    4. 最も左上（上が優先）にある keyword に一致するセルより上および左の行・列をデータから除きます。
 
     Args:
         book_path: Excel book のパス。
@@ -29,7 +35,7 @@ def parse_excel(book_path, sheet_name, keyword, required, optional, raise_if_no_
         keyword (str): 必ず含まれるべき、表データの最初の列名として使う文字列。
         required (list[str]): 必ず含まれるべき、表データの列名として使う文字列のリスト。
         optional (list[str]): 表データの列名として使ってよい文字列のリスト。
-        raise_if_no_keyword (bool, optional): 指定されたシートに keyword が含まれない場合エラーにするかどうか。
+        raise_if_no_keyword (bool): キーワードがなかった場合エラーとするか。
 
     Returns:
 
@@ -55,6 +61,7 @@ def parse_excel(book_path, sheet_name, keyword, required, optional, raise_if_no_
     df = pd.DataFrame(df.iloc[1+r:, c:].values, columns=df.iloc[r, c:].values)
 
     # NaN のみからなる行を最初に見つけるまでデータに追加する
+    # <=> 表の下限を決める
     valid_rows = []
     for row in df.index:
         if df.loc[row].notna().sum():
@@ -63,10 +70,36 @@ def parse_excel(book_path, sheet_name, keyword, required, optional, raise_if_no_
             break
     df = df.loc[valid_rows]
 
-    # NaN のみからなる列を削除する
+    # NaN のみからなる列を削除する <=> 表の右限を決める
     valid_columns = [col for i, col in enumerate(df.columns) if df.iloc[:, i].notna().sum()]
     df = df[valid_columns]
 
+    # choices は list に変換する
+    key = ParseAsParameter.choices
+    if key in df.columns:
+        if key in df.columns:
+            choices = []
+            for v in df[key]:
+                v = str(v)
+                if v == 'nan':
+                    choices.append('[]')  # _reconvert_objects の中で SyntaxError になるため。後で置換する。
+                else:
+                    if not v.startswith('['):
+                        v = f'[{v}'
+                    if not v.endswith(']'):
+                        v = f'{v}]'
+                    choices.append(v)
+
+            df[key] = choices
+
+        dummy_meta_columns = ['prm.cat.choices' if (column == key)
+                              else ''
+                              for column in df.columns]
+
+        ColumnManager._reconvert_objects(df, dummy_meta_columns)
+
+        df[key] = [_EMPTY_CHOICE if len(v) == 0 else v for v in df[key]]
+
     # パースが成功しているかチェックする
     lack = True
     for col in df.columns:
@@ -87,15 +120,8 @@ class ParseBase:
     OPTIONAL_COLUMNS = []
 
     @classmethod
-    def parse(cls, book_path, sheet_name, raise_if_no_keyword=True) -> pd.DataFrame:
-        return parse_excel(
-            book_path,
-            sheet_name,
-            cls.KEYWORD,
-            cls.REQUIRED_COLUMNS,
-            cls.OPTIONAL_COLUMNS,
-            raise_if_no_keyword,
-        )
+    def parse(cls, book_path, sheet_name, raise_if_no_keyword) -> pd.DataFrame:
+        return parse_excel(book_path, sheet_name, cls.KEYWORD, cls.REQUIRED_COLUMNS, cls.OPTIONAL_COLUMNS, raise_if_no_keyword)
 
 
 class ParseAsParameter(ParseBase):
@@ -104,10 +130,11 @@ class ParseAsParameter(ParseBase):
     lb = '下限'
     ub = '上限'
     step = 'ステップ'
+    choices = '選択肢'
     use = '使用'
     KEYWORD = name
     REQUIRED_COLUMNS = [value, lb, ub]
-    OPTIONAL_COLUMNS = [step, use]
+    OPTIONAL_COLUMNS = [step, choices, use]
 
 
 class ParseAsObjective(ParseBase):
@@ -147,10 +174,3 @@ def search_r(book_path, sheet_name, value):
 
 def search_c(book_path, sheet_name, value):
     return search_index(book_path, sheet_name, value)[1]
-
-
-if __name__ == '__main__':
-    os.chdir(os.path.dirname(__file__))
-    print(ParseAsParameter.parse('sample.xlsx', 'Sheet1'))
-    print(search_r('sample.xlsx', 'Sheet1', 'X2'))
-    print(search_c('sample.xlsx', 'Sheet1', '値'))

pyfemtet/_util/femtet_access_inspection.py

@@ -0,0 +1,120 @@
+import ast
+import inspect
+
+
+__all__ = [
+    '_is_access_gogh',
+    '_is_access_femtet',
+]
+
+
+def _get_scope_indent(source: str) -> int:
+    SPACES = [' ', '\t']
+    indent = 0
+    while True:
+        if source[indent] not in SPACES:
+            break
+        else:
+            indent += 1
+    return indent
+
+
+def _remove_indent(source: str, indent: int) -> str:  # returns source
+    lines = source.splitlines()
+    edited_lines = [l[indent:] for l in lines]
+    edited_source = '\n'.join(edited_lines)
+    return edited_source
+
+
+def _check_access_femtet_objects(fun, target: str = 'Femtet'):
+
+    # 関数fのソースコードを取得
+    source = inspect.getsource(fun)
+
+    # ソースコードを抽象構文木（AST）に変換
+    try:
+        # instanceメソッドなどの場合を想定してインデントを削除
+        source = _remove_indent(source, _get_scope_indent(source))
+        tree = ast.parse(source)
+
+    except Exception:
+        return False  # パースに失敗するからと言ってエラーにするまででもない
+
+    # if function or staticmethod, 1st argument is Femtet. Find the name.
+    varname_contains_femtet = ''  # invalid variable name
+    for node in ast.walk(tree):
+        if isinstance(node, ast.FunctionDef):
+            all_arguments: ast.arguments = node.args
+
+            args: list[ast.arg] = all_arguments.args
+            # args.extend(all_arguments.posonlyargs)  # 先にこっちを入れるべきかも
+
+            target_arg = args[0]
+
+            # if class method or instance method, 2nd argument is it.
+            # In this implementation, we cannot detect the FunctionDef is
+            # method or not because the part of source code is unindented and parsed.
+            if target_arg.arg == 'self' or target_arg.arg == 'cls':
+                if len(args) > 1:
+                    target_arg = args[1]
+                else:
+                    target_arg = None
+
+            if target_arg is not None:
+                varname_contains_femtet = target_arg.arg
+
+    # check Femtet access
+    if target == 'Femtet':
+        for node in ast.walk(tree):
+
+            # by accessing argument directory
+            if isinstance(node, ast.Name):
+                # found local variables
+                node: ast.Name
+                if node.id == varname_contains_femtet:
+                    # found Femtet
+                    return True
+
+            # by accessing inside method
+            elif isinstance(node, ast.Attribute):
+                # found attribute of something
+                node: ast.Attribute
+                if node.attr == 'Femtet':
+                    # found **.Femtet.**
+                    return True
+
+    # check Gogh access
+    elif target == 'Gogh':
+        for node in ast.walk(tree):
+            if isinstance(node, ast.Attribute):
+                if node.attr == 'Gogh':
+                    # found **.Gogh.**
+                    node: ast.Attribute
+                    parent = node.value
+
+                    # by accessing argument directory
+                    if isinstance(parent, ast.Name):
+                        # found *.Gogh.**
+                        parent: ast.Name
+                        if parent.id == varname_contains_femtet:
+                            # found Femtet.Gogh.**
+                            return True
+
+                    # by accessing inside method
+                    if isinstance(parent, ast.Attribute):
+                        # found **.*.Gogh.**
+                        parent: ast.Attribute
+                        if parent.attr == 'Femtet':
+                            # found **.Femtet.Gogh.**
+                            return True
+
+    # ここまで来たならば target へのアクセスはおそらくない
+    return False
+
+
+def _is_access_gogh(fun: callable) -> bool:
+    return _check_access_femtet_objects(fun, target='Gogh')
+
+
+def _is_access_femtet(fun: callable) -> bool:
+    return _check_access_femtet_objects(fun, target='Femtet')

pyfemtet/{_femtet_config_util/autosave.py → _util/femtet_autosave.py}

@@ -1,6 +1,13 @@
 import winreg
 from typing import Final
 
+
+__all__ = [
+    '_get_autosave_enabled',
+    '_set_autosave_enabled',
+]
+
+
 # レジストリのパスと値の名前
 _REGISTRY_PATH: Final[str] = r"SOFTWARE\Murata Software\Femtet2014\Femtet"
 _VALUE_NAME: Final[str] = "AutoSave"