low.actions
900+ HWP 액션 래퍼.
API 시그니처와 docstring 은 Python 소스에서 자동 생성되어 영문으로 표시됩니다.
actions._Actions
low.actions._Actions(app)Dynamic action dispatcher with instance caching.
Actions are resolved via getattr using the _action_info dict. Resolved _Action instances are cached so repeated access does not trigger repeated COM calls.
Usage: app.actions.CharShape # cached _Action app.actions.get_pset_class(…) # introspect without COM app.actions.refresh() # clear cache ‘CharShape’ in app.actions # membership test
Methods
| Name | Description |
|---|---|
| get_description | Get action description without creating _Action. |
| get_pset_class | Get the ParameterSet class for an action WITHOUT creating _Action. |
| list_actions | List all available action names. |
| refresh | Invalidate cache; next access creates fresh _Action with HWP defaults. |
get_description
low.actions._Actions.get_description(action_name)Get action description without creating _Action.
get_pset_class
low.actions._Actions.get_pset_class(action_name)Get the ParameterSet class for an action WITHOUT creating _Action.
This is a cheap introspection — no COM calls.
Returns: ParameterSet subclass, or None if the action has no pset.
Raises: KeyError: if action_name is unknown.
list_actions
low.actions._Actions.list_actions(with_pset_only=False)List all available action names.
Args: with_pset_only: if True, return only actions that have a ParameterSet.
refresh
low.actions._Actions.refresh(name=None)Invalidate cache; next access creates fresh _Action with HWP defaults.
Args: name: action name to refresh. None clears entire cache.
actions._Action
low.actions._Action(app, action_key)한글 Action 클래스. app.api.CreateAction() 로 생성되는 HWP 액션을 감싼 얇은 래퍼.
문서 바인딩 규칙 (v0.0.4+): CreateAction() 은 호출 시점의 활성 문서 에 바인딩된 action 을 반환합니다. 과거에는 __init__ 에서 한 번만 호출했기 때문에 이후 다른 문서로 전환해도 action 이 원래 문서에 계속 writes 하는 버그가 있었습니다.
이제는 act 와 pset 을 활성 문서 ID 별로 lazy-cache 합니다. 동일 문서에서는 캐시 히트, 다른 문서로 전환하면 자동으로 새 action 을 생성합니다. Public API 는 기존과 동일합니다.
Attributes
| Name | Description |
|---|---|
| act | 현재 활성 문서에 바인딩된 IXHwpAction. |
| pset | 현재 활성 문서에 바인딩된 wrapped ParameterSet. |
Methods
| Name | Description |
|---|---|
| get_pset | Return ParameterSet bound to global HParameterSet node (HAction pattern). |
| run | Execute the action using pset-based approach. |
get_pset
low.actions._Action.get_pset()Return ParameterSet bound to global HParameterSet node (HAction pattern).
This is the ‘HAction’ style described in HWP Automation docs (p.60): HAction.GetDefault(actname, HParameterSet.HXxx.HSet) HParameterSet.HXxx.
The returned ParameterSet shares state with the global HParameterSet, unlike .pset which uses a local pset from CreateSet().
run
low.actions._Action.run(parameterset=None)Execute the action using pset-based approach. Direct execution with pset objects without HSet synchronization.