code0-hercules 1.3.0__tar.gz

code0_hercules-1.3.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: code0-hercules
+Version: 1.3.0
+Summary: Python SDK for the hercules action runner
+License-Expression: MIT
+Project-URL: Repository, https://github.com/code0-tech/hercules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: grpcio>=1.64
+Requires-Dist: protobuf>=5.0
+Requires-Dist: tucana>=0.0.82
+Requires-Dist: pydantic>=2
+Provides-Extra: codegen
+Requires-Dist: datamodel-code-generator>=0.25; extra == "codegen"
+
+# code0-hercules (Python)
+
+Python SDK for the hercules action runner — the counterpart to the TypeScript
+`@code0-tech/hercules` package. Define data types, functions, and events, and
+connect them to aquila.
+
+## Install
+
+```bash
+pip install code0-hercules
+```
+
+Requirements:
+
+- **Python 3.10+**
+- **Node.js** — data-type schemas are converted to/from TypeScript via a bundled
+  Node helper (`hercules/_tsgen`). Its npm dependencies are installed automatically
+  on first use.
+
+## Develop
+
+This project uses [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv sync                                   # create .venv + install (incl. dev deps)
+npm ci --prefix hercules/_tsgen           # install the Node schema helper
+uv run pytest                             # run the tests
+```
+
+The runnable example lives in [`examples/simple-example-py`](examples/simple-example-py).
+
+## Built-in definitions
+
+The built-in data types / functions in `hercules/definitions/` are **generated**
+(not committed) from a [`code0-definition`](https://github.com/code0-tech/code0-definition)
+release:
+
+```bash
+uv run python scripts/build_definitions.py --version def-0.0.35
+```
+
+## Build & release
+
+Packages are built with `uv build` and published to PyPI from CI:
+
+- **`build.yml`** builds and tests the package on every push.
+- **`publish.yml`** runs on a pushed git tag: it sets the package version from the
+  tag, regenerates the definitions, builds, and publishes to PyPI via
+  [trusted publishing](https://docs.pypi.org/trusted-publishers/) (OIDC — no token).
+
+To cut a release, push a PEP 440 version tag (e.g. `0.1.0`):
+
+```bash
+git tag 0.1.0 && git push origin 0.1.0
+```
+
+The `code0-definition` release used for the built-in definitions is controlled by
+the `HERCULES_DEFINITIONS_VERSION` repository variable (default `def-0.0.35`).
+
+Build locally:
+
+```bash
+uv build          # -> dist/*.whl and dist/*.tar.gz
+```

code0_hercules-1.3.0/README.md

@@ -0,0 +1,64 @@
+# code0-hercules (Python)
+
+Python SDK for the hercules action runner — the counterpart to the TypeScript
+`@code0-tech/hercules` package. Define data types, functions, and events, and
+connect them to aquila.
+
+## Install
+
+```bash
+pip install code0-hercules
+```
+
+Requirements:
+
+- **Python 3.10+**
+- **Node.js** — data-type schemas are converted to/from TypeScript via a bundled
+  Node helper (`hercules/_tsgen`). Its npm dependencies are installed automatically
+  on first use.
+
+## Develop
+
+This project uses [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv sync                                   # create .venv + install (incl. dev deps)
+npm ci --prefix hercules/_tsgen           # install the Node schema helper
+uv run pytest                             # run the tests
+```
+
+The runnable example lives in [`examples/simple-example-py`](examples/simple-example-py).
+
+## Built-in definitions
+
+The built-in data types / functions in `hercules/definitions/` are **generated**
+(not committed) from a [`code0-definition`](https://github.com/code0-tech/code0-definition)
+release:
+
+```bash
+uv run python scripts/build_definitions.py --version def-0.0.35
+```
+
+## Build & release
+
+Packages are built with `uv build` and published to PyPI from CI:
+
+- **`build.yml`** builds and tests the package on every push.
+- **`publish.yml`** runs on a pushed git tag: it sets the package version from the
+  tag, regenerates the definitions, builds, and publishes to PyPI via
+  [trusted publishing](https://docs.pypi.org/trusted-publishers/) (OIDC — no token).
+
+To cut a release, push a PEP 440 version tag (e.g. `0.1.0`):
+
+```bash
+git tag 0.1.0 && git push origin 0.1.0
+```
+
+The `code0-definition` release used for the built-in definitions is controlled by
+the `HERCULES_DEFINITIONS_VERSION` repository variable (default `def-0.0.35`).
+
+Build locally:
+
+```bash
+uv build          # -> dist/*.whl and dist/*.tar.gz
+```

code0_hercules-1.3.0/code0_hercules.egg-info/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: code0-hercules
+Version: 1.3.0
+Summary: Python SDK for the hercules action runner
+License-Expression: MIT
+Project-URL: Repository, https://github.com/code0-tech/hercules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: grpcio>=1.64
+Requires-Dist: protobuf>=5.0
+Requires-Dist: tucana>=0.0.82
+Requires-Dist: pydantic>=2
+Provides-Extra: codegen
+Requires-Dist: datamodel-code-generator>=0.25; extra == "codegen"
+
+# code0-hercules (Python)
+
+Python SDK for the hercules action runner — the counterpart to the TypeScript
+`@code0-tech/hercules` package. Define data types, functions, and events, and
+connect them to aquila.
+
+## Install
+
+```bash
+pip install code0-hercules
+```
+
+Requirements:
+
+- **Python 3.10+**
+- **Node.js** — data-type schemas are converted to/from TypeScript via a bundled
+  Node helper (`hercules/_tsgen`). Its npm dependencies are installed automatically
+  on first use.
+
+## Develop
+
+This project uses [uv](https://docs.astral.sh/uv/).
+
+```bash
+uv sync                                   # create .venv + install (incl. dev deps)
+npm ci --prefix hercules/_tsgen           # install the Node schema helper
+uv run pytest                             # run the tests
+```
+
+The runnable example lives in [`examples/simple-example-py`](examples/simple-example-py).
+
+## Built-in definitions
+
+The built-in data types / functions in `hercules/definitions/` are **generated**
+(not committed) from a [`code0-definition`](https://github.com/code0-tech/code0-definition)
+release:
+
+```bash
+uv run python scripts/build_definitions.py --version def-0.0.35
+```
+
+## Build & release
+
+Packages are built with `uv build` and published to PyPI from CI:
+
+- **`build.yml`** builds and tests the package on every push.
+- **`publish.yml`** runs on a pushed git tag: it sets the package version from the
+  tag, regenerates the definitions, builds, and publishes to PyPI via
+  [trusted publishing](https://docs.pypi.org/trusted-publishers/) (OIDC — no token).
+
+To cut a release, push a PEP 440 version tag (e.g. `0.1.0`):
+
+```bash
+git tag 0.1.0 && git push origin 0.1.0
+```
+
+The `code0-definition` release used for the built-in definitions is controlled by
+the `HERCULES_DEFINITIONS_VERSION` repository variable (default `def-0.0.35`).
+
+Build locally:
+
+```bash
+uv build          # -> dist/*.whl and dist/*.tar.gz
+```

code0_hercules-1.3.0/code0_hercules.egg-info/SOURCES.txt

@@ -0,0 +1,265 @@
+README.md
+pyproject.toml
+code0_hercules.egg-info/PKG-INFO
+code0_hercules.egg-info/SOURCES.txt
+code0_hercules.egg-info/dependency_links.txt
+code0_hercules.egg-info/entry_points.txt
+code0_hercules.egg-info/requires.txt
+code0_hercules.egg-info/top_level.txt
+hercules/__init__.py
+hercules/_metadata.py
+hercules/action.py
+hercules/cli.py
+hercules/events.py
+hercules/schema.py
+hercules/types.py
+hercules/_tsgen/convert.mjs
+hercules/_tsgen/package-lock.json
+hercules/_tsgen/package.json
+hercules/_tucana/__init__.py
+hercules/_tucana/helpers.py
+hercules/actions/__init__.py
+hercules/actions/execution.py
+hercules/actions/flow_execution.py
+hercules/actions/flow_update.py
+hercules/actions/module_configurations.py
+hercules/actions/sub_flow_execution.py
+hercules/decorators/__init__.py
+hercules/decorators/datatype.py
+hercules/decorators/event.py
+hercules/decorators/function.py
+hercules/decorators/meta.py
+hercules/decorators/runtime_event.py
+hercules/decorators/runtime_function.py
+hercules/definitions/__init__.py
+hercules/definitions/cron_action/__init__.py
+hercules/definitions/cron_action/data_types/__init__.py
+hercules/definitions/cron_action/data_types/cron_day_of_month.py
+hercules/definitions/cron_action/data_types/cron_day_of_week.py
+hercules/definitions/cron_action/data_types/cron_hour.py
+hercules/definitions/cron_action/data_types/cron_minute.py
+hercules/definitions/cron_action/data_types/cron_month.py
+hercules/definitions/cron_action/runtime_flow_types/__init__.py
+hercules/definitions/cron_action/runtime_flow_types/cron.py
+hercules/definitions/rest_action/__init__.py
+hercules/definitions/rest_action/data_types/__init__.py
+hercules/definitions/rest_action/data_types/rest_adapter_input.py
+hercules/definitions/rest_action/data_types/rest_auth_type.py
+hercules/definitions/rest_action/data_types/rest_auth_value.py
+hercules/definitions/rest_action/runtime_flow_types/__init__.py
+hercules/definitions/rest_action/runtime_flow_types/rest.py
+hercules/definitions/rest_action/runtime_functions/__init__.py
+hercules/definitions/rest_action/runtime_functions/rest_control_respond.py
+hercules/definitions/taurus_boolean/__init__.py
+hercules/definitions/taurus_boolean/data_types/__init__.py
+hercules/definitions/taurus_boolean/data_types/boolean.py
+hercules/definitions/taurus_boolean/runtime_functions/__init__.py
+hercules/definitions/taurus_boolean/runtime_functions/std_boolean_as_number.py
+hercules/definitions/taurus_boolean/runtime_functions/std_boolean_as_text.py
+hercules/definitions/taurus_boolean/runtime_functions/std_boolean_from_number.py
+hercules/definitions/taurus_boolean/runtime_functions/std_boolean_from_text.py
+hercules/definitions/taurus_boolean/runtime_functions/std_boolean_is_equal.py
+hercules/definitions/taurus_boolean/runtime_functions/std_boolean_negate.py
+hercules/definitions/taurus_color/__init__.py
+hercules/definitions/taurus_color/data_types/__init__.py
+hercules/definitions/taurus_color/data_types/color.py
+hercules/definitions/taurus_color/runtime_functions/__init__.py
+hercules/definitions/taurus_color/runtime_functions/std_color_as_hex.py
+hercules/definitions/taurus_color/runtime_functions/std_color_as_hsl.py
+hercules/definitions/taurus_color/runtime_functions/std_color_as_rgb.py
+hercules/definitions/taurus_color/runtime_functions/std_color_from_hex.py
+hercules/definitions/taurus_color/runtime_functions/std_color_from_hsl.py
+hercules/definitions/taurus_color/runtime_functions/std_color_from_rgb.py
+hercules/definitions/taurus_control/__init__.py
+hercules/definitions/taurus_control/data_types/__init__.py
+hercules/definitions/taurus_control/data_types/comparator.py
+hercules/definitions/taurus_control/data_types/consumer.py
+hercules/definitions/taurus_control/data_types/predicate.py
+hercules/definitions/taurus_control/data_types/runnable.py
+hercules/definitions/taurus_control/data_types/transform.py
+hercules/definitions/taurus_control/runtime_functions/__init__.py
+hercules/definitions/taurus_control/runtime_functions/std_control_if.py
+hercules/definitions/taurus_control/runtime_functions/std_control_if_else.py
+hercules/definitions/taurus_control/runtime_functions/std_control_return.py
+hercules/definitions/taurus_control/runtime_functions/std_control_stop.py
+hercules/definitions/taurus_control/runtime_functions/std_control_value.py
+hercules/definitions/taurus_date/__init__.py
+hercules/definitions/taurus_date/data_types/__init__.py
+hercules/definitions/taurus_date/data_types/date.py
+hercules/definitions/taurus_date/data_types/hour.py
+hercules/definitions/taurus_date/data_types/minute.py
+hercules/definitions/taurus_date/data_types/month.py
+hercules/definitions/taurus_date/runtime_functions/__init__.py
+hercules/definitions/taurus_date/runtime_functions/std_date_format.py
+hercules/definitions/taurus_date/runtime_functions/std_date_from.py
+hercules/definitions/taurus_date/runtime_functions/std_date_from_text.py
+hercules/definitions/taurus_date/runtime_functions/std_date_from_unix.py
+hercules/definitions/taurus_date/runtime_functions/std_date_now.py
+hercules/definitions/taurus_file/__init__.py
+hercules/definitions/taurus_file/data_types/__init__.py
+hercules/definitions/taurus_file/data_types/file.py
+hercules/definitions/taurus_file/runtime_functions/__init__.py
+hercules/definitions/taurus_file/runtime_functions/std_file_size.py
+hercules/definitions/taurus_http/__init__.py
+hercules/definitions/taurus_http/data_types/__init__.py
+hercules/definitions/taurus_http/data_types/http_auth_place.py
+hercules/definitions/taurus_http/data_types/http_auth_type.py
+hercules/definitions/taurus_http/data_types/http_auth_value.py
+hercules/definitions/taurus_http/data_types/http_method.py
+hercules/definitions/taurus_http/data_types/http_payload.py
+hercules/definitions/taurus_http/data_types/http_request.py
+hercules/definitions/taurus_http/data_types/http_response.py
+hercules/definitions/taurus_http/data_types/http_schema.py
+hercules/definitions/taurus_http/data_types/http_status_code.py
+hercules/definitions/taurus_http/data_types/http_url.py
+hercules/definitions/taurus_http/runtime_functions/__init__.py
+hercules/definitions/taurus_http/runtime_functions/http_request_send.py
+hercules/definitions/taurus_list/__init__.py
+hercules/definitions/taurus_list/data_types/__init__.py
+hercules/definitions/taurus_list/data_types/list.py
+hercules/definitions/taurus_list/runtime_functions/__init__.py
+hercules/definitions/taurus_list/runtime_functions/std_list_at.py
+hercules/definitions/taurus_list/runtime_functions/std_list_concat.py
+hercules/definitions/taurus_list/runtime_functions/std_list_filter.py
+hercules/definitions/taurus_list/runtime_functions/std_list_find.py
+hercules/definitions/taurus_list/runtime_functions/std_list_find_index.py
+hercules/definitions/taurus_list/runtime_functions/std_list_find_last.py
+hercules/definitions/taurus_list/runtime_functions/std_list_first.py
+hercules/definitions/taurus_list/runtime_functions/std_list_flat.py
+hercules/definitions/taurus_list/runtime_functions/std_list_for_each.py
+hercules/definitions/taurus_list/runtime_functions/std_list_index_of.py
+hercules/definitions/taurus_list/runtime_functions/std_list_is_empty.py
+hercules/definitions/taurus_list/runtime_functions/std_list_join.py
+hercules/definitions/taurus_list/runtime_functions/std_list_last.py
+hercules/definitions/taurus_list/runtime_functions/std_list_map.py
+hercules/definitions/taurus_list/runtime_functions/std_list_max.py
+hercules/definitions/taurus_list/runtime_functions/std_list_min.py
+hercules/definitions/taurus_list/runtime_functions/std_list_pop.py
+hercules/definitions/taurus_list/runtime_functions/std_list_push.py
+hercules/definitions/taurus_list/runtime_functions/std_list_remove.py
+hercules/definitions/taurus_list/runtime_functions/std_list_reverse.py
+hercules/definitions/taurus_list/runtime_functions/std_list_size.py
+hercules/definitions/taurus_list/runtime_functions/std_list_sort.py
+hercules/definitions/taurus_list/runtime_functions/std_list_sort_reverse.py
+hercules/definitions/taurus_list/runtime_functions/std_list_sum.py
+hercules/definitions/taurus_list/runtime_functions/std_list_to_unique.py
+hercules/definitions/taurus_number/__init__.py
+hercules/definitions/taurus_number/data_types/__init__.py
+hercules/definitions/taurus_number/data_types/number.py
+hercules/definitions/taurus_number/runtime_functions/__init__.py
+hercules/definitions/taurus_number/runtime_functions/std_number_abs.py
+hercules/definitions/taurus_number/runtime_functions/std_number_add.py
+hercules/definitions/taurus_number/runtime_functions/std_number_arccos.py
+hercules/definitions/taurus_number/runtime_functions/std_number_arcsin.py
+hercules/definitions/taurus_number/runtime_functions/std_number_arctan.py
+hercules/definitions/taurus_number/runtime_functions/std_number_as_text.py
+hercules/definitions/taurus_number/runtime_functions/std_number_clamp.py
+hercules/definitions/taurus_number/runtime_functions/std_number_cos.py
+hercules/definitions/taurus_number/runtime_functions/std_number_cosh.py
+hercules/definitions/taurus_number/runtime_functions/std_number_divide.py
+hercules/definitions/taurus_number/runtime_functions/std_number_euler.py
+hercules/definitions/taurus_number/runtime_functions/std_number_exponential.py
+hercules/definitions/taurus_number/runtime_functions/std_number_from_text.py
+hercules/definitions/taurus_number/runtime_functions/std_number_has_digits.py
+hercules/definitions/taurus_number/runtime_functions/std_number_is_equal.py
+hercules/definitions/taurus_number/runtime_functions/std_number_is_greater.py
+hercules/definitions/taurus_number/runtime_functions/std_number_is_less.py
+hercules/definitions/taurus_number/runtime_functions/std_number_is_positive.py
+hercules/definitions/taurus_number/runtime_functions/std_number_is_zero.py
+hercules/definitions/taurus_number/runtime_functions/std_number_ln.py
+hercules/definitions/taurus_number/runtime_functions/std_number_log.py
+hercules/definitions/taurus_number/runtime_functions/std_number_max.py
+hercules/definitions/taurus_number/runtime_functions/std_number_min.py
+hercules/definitions/taurus_number/runtime_functions/std_number_modulo.py
+hercules/definitions/taurus_number/runtime_functions/std_number_multiply.py
+hercules/definitions/taurus_number/runtime_functions/std_number_negate.py
+hercules/definitions/taurus_number/runtime_functions/std_number_pi.py
+hercules/definitions/taurus_number/runtime_functions/std_number_random_number.py
+hercules/definitions/taurus_number/runtime_functions/std_number_remove_digits.py
+hercules/definitions/taurus_number/runtime_functions/std_number_root.py
+hercules/definitions/taurus_number/runtime_functions/std_number_round.py
+hercules/definitions/taurus_number/runtime_functions/std_number_round_down.py
+hercules/definitions/taurus_number/runtime_functions/std_number_round_up.py
+hercules/definitions/taurus_number/runtime_functions/std_number_sin.py
+hercules/definitions/taurus_number/runtime_functions/std_number_sinh.py
+hercules/definitions/taurus_number/runtime_functions/std_number_square.py
+hercules/definitions/taurus_number/runtime_functions/std_number_square_root.py
+hercules/definitions/taurus_number/runtime_functions/std_number_subtract.py
+hercules/definitions/taurus_number/runtime_functions/std_number_tan.py
+hercules/definitions/taurus_object/__init__.py
+hercules/definitions/taurus_object/data_types/__init__.py
+hercules/definitions/taurus_object/data_types/object.py
+hercules/definitions/taurus_object/data_types/type.py
+hercules/definitions/taurus_object/runtime_functions/__init__.py
+hercules/definitions/taurus_object/runtime_functions/std_object_contains_key.py
+hercules/definitions/taurus_object/runtime_functions/std_object_get.py
+hercules/definitions/taurus_object/runtime_functions/std_object_keys.py
+hercules/definitions/taurus_object/runtime_functions/std_object_set.py
+hercules/definitions/taurus_object/runtime_functions/std_object_size.py
+hercules/definitions/taurus_text/__init__.py
+hercules/definitions/taurus_text/data_types/__init__.py
+hercules/definitions/taurus_text/data_types/text.py
+hercules/definitions/taurus_text/data_types/text_encoding.py
+hercules/definitions/taurus_text/runtime_functions/__init__.py
+hercules/definitions/taurus_text/runtime_functions/std_text_append.py
+hercules/definitions/taurus_text/runtime_functions/std_text_as_bytes.py
+hercules/definitions/taurus_text/runtime_functions/std_text_at.py
+hercules/definitions/taurus_text/runtime_functions/std_text_byte_size.py
+hercules/definitions/taurus_text/runtime_functions/std_text_capitalize.py
+hercules/definitions/taurus_text/runtime_functions/std_text_chars.py
+hercules/definitions/taurus_text/runtime_functions/std_text_contains.py
+hercules/definitions/taurus_text/runtime_functions/std_text_decode.py
+hercules/definitions/taurus_text/runtime_functions/std_text_encode.py
+hercules/definitions/taurus_text/runtime_functions/std_text_ends_with.py
+hercules/definitions/taurus_text/runtime_functions/std_text_from_ascii.py
+hercules/definitions/taurus_text/runtime_functions/std_text_hex.py
+hercules/definitions/taurus_text/runtime_functions/std_text_index_of.py
+hercules/definitions/taurus_text/runtime_functions/std_text_insert.py
+hercules/definitions/taurus_text/runtime_functions/std_text_is_equal.py
+hercules/definitions/taurus_text/runtime_functions/std_text_length.py
+hercules/definitions/taurus_text/runtime_functions/std_text_lowercase.py
+hercules/definitions/taurus_text/runtime_functions/std_text_octal.py
+hercules/definitions/taurus_text/runtime_functions/std_text_prepend.py
+hercules/definitions/taurus_text/runtime_functions/std_text_remove.py
+hercules/definitions/taurus_text/runtime_functions/std_text_replace.py
+hercules/definitions/taurus_text/runtime_functions/std_text_replace_first.py
+hercules/definitions/taurus_text/runtime_functions/std_text_replace_last.py
+hercules/definitions/taurus_text/runtime_functions/std_text_reverse.py
+hercules/definitions/taurus_text/runtime_functions/std_text_split.py
+hercules/definitions/taurus_text/runtime_functions/std_text_starts_with.py
+hercules/definitions/taurus_text/runtime_functions/std_text_swapcase.py
+hercules/definitions/taurus_text/runtime_functions/std_text_to_ascii.py
+hercules/definitions/taurus_text/runtime_functions/std_text_trim.py
+hercules/definitions/taurus_text/runtime_functions/std_text_uppercase.py
+hercules/internal/__init__.py
+hercules/internal/connection.py
+hercules/internal/literal.py
+hercules/internal/module_builder.py
+hercules/internal/pydantic_codegen.py
+hercules/internal/schema.py
+hercules/internal/tsgen.py
+hercules/manager/__init__.py
+hercules/manager/base.py
+hercules/manager/config.py
+hercules/manager/datatype.py
+hercules/manager/event.py
+hercules/manager/flow.py
+hercules/manager/function.py
+hercules/manager/runtime_event.py
+hercules/manager/runtime_function.py
+hercules/map/__init__.py
+hercules/map/datatype.py
+hercules/map/event.py
+hercules/map/function.py
+hercules/map/runtime_event.py
+hercules/map/runtime_function.py
+hercules/models/__init__.py
+hercules/models/datatype.py
+hercules/models/event.py
+hercules/models/function.py
+hercules/models/runtime_event.py
+hercules/models/runtime_function.py
+tests/test_datatype.py
+tests/test_export.py
+tests/test_index.py
+tests/test_literal.py

code0_hercules-1.3.0/code0_hercules.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

code0_hercules-1.3.0/code0_hercules.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+hercules = hercules.cli:main

code0_hercules-1.3.0/code0_hercules.egg-info/requires.txt

@@ -0,0 +1,7 @@
+grpcio>=1.64
+protobuf>=5.0
+tucana>=0.0.82
+pydantic>=2
+
+[codegen]
+datamodel-code-generator>=0.25

code0_hercules-1.3.0/code0_hercules.egg-info/top_level.txt

@@ -0,0 +1 @@
+hercules

code0_hercules-1.3.0/hercules/__init__.py

@@ -0,0 +1,81 @@
+"""hercules — the action SDK to connect with aquila (Python).
+
+Public API mirror of the TypeScript ``src/index.ts`` re-exports.
+"""
+from __future__ import annotations
+
+# Must run before any module that imports the tucana protobufs: it puts
+# ``tucana/generated`` on sys.path so the generated protos' internal
+# ``from shared import ...`` / ``from aquila import ...`` imports resolve.
+import hercules._tucana  # noqa: F401  isort: skip
+
+from hercules.types import (
+    ConfigurationDefinition,
+    FlowTypeSetting_UniquenessScope,
+    FunctionContext,
+    PlainValue,
+    ProjectConfiguration,
+    RuntimeError,
+    RuntimeFlowTypeSetting_UniquenessScope,
+    SubFlow,
+    Translation,
+)
+from hercules.events import CodeZeroEvent
+from hercules.schema import (
+    Annotated,
+    BaseModel,
+    ConfigDict,
+    Field,
+    RootModel,
+    StringConstraints,
+    Schema as SchemaType,
+)
+from hercules.decorators.meta import (
+    Alias,
+    DeprecationMessage,
+    Description,
+    DisplayIcon,
+    DisplayMessage,
+    Documentation,
+    Editable,
+    Identifier,
+    Name,
+    Signature,
+)
+from hercules.decorators.function import Design, OmitFunction, Parameter, ThrowsError
+from hercules.decorators.datatype import Schema, TypeString
+from hercules.decorators.event import EventSetting
+from hercules.decorators.runtime_event import OmitEvent
+from hercules.decorators.runtime_function import OmitRuntimeFunction
+from hercules.manager.base import BaseManager
+from hercules.manager.config import ConfigManager
+from hercules.manager.datatype import DataTypeManager
+from hercules.manager.event import EventManager
+from hercules.manager.flow import FlowManager
+from hercules.manager.function import FunctionManager
+from hercules.manager.runtime_event import RuntimeEventManager
+from hercules.manager.runtime_function import RuntimeFunctionManager
+from hercules.models.datatype import DataTypeProps, DataTypeRunnable
+from hercules.models.event import EventModel, EventSettingProps
+from hercules.models.function import FunctionParameterProps, FunctionProps
+from hercules.models.runtime_event import RuntimeEventProps, RuntimeEventRunnable
+from hercules.models.runtime_function import RuntimeFunctionProps, RuntimeFunctionRunnable
+from hercules.action import Action, is_export_mode, registered_actions
+
+__all__ = [
+    "Translation", "PlainValue", "SubFlow", "FunctionContext",
+    "ProjectConfiguration", "ConfigurationDefinition", "RuntimeError",
+    "FlowTypeSetting_UniquenessScope", "RuntimeFlowTypeSetting_UniquenessScope",
+    "CodeZeroEvent", "SchemaType",
+    "BaseModel", "RootModel", "Field", "StringConstraints", "ConfigDict", "Annotated",
+    "Identifier", "Name", "Description", "Documentation", "DisplayMessage",
+    "Alias", "DeprecationMessage", "Signature", "DisplayIcon", "Editable",
+    "OmitFunction", "Design", "ThrowsError", "Parameter", "Schema", "TypeString",
+    "EventSetting", "OmitEvent", "OmitRuntimeFunction",
+    "BaseManager", "ConfigManager", "FlowManager", "FunctionManager",
+    "RuntimeFunctionManager", "DataTypeManager", "EventManager", "RuntimeEventManager",
+    "FunctionProps", "FunctionParameterProps", "RuntimeFunctionProps",
+    "RuntimeFunctionRunnable", "DataTypeProps", "DataTypeRunnable", "EventModel",
+    "EventSettingProps", "RuntimeEventProps", "RuntimeEventRunnable",
+    "Action", "is_export_mode", "registered_actions",
+]

code0_hercules-1.3.0/hercules/_metadata.py

@@ -0,0 +1,38 @@
+"""Class metadata store — Python equivalent of ``reflect-metadata``.
+
+Metadata is attached to classes under a private per-class dict. ``get_metadata``
+walks the MRO (like ``Reflect.getMetadata`` walking the prototype chain), while
+``get_own_metadata`` only inspects the class itself (like ``getOwnMetadata``).
+"""
+from __future__ import annotations
+
+from typing import Any
+
+_OWN = "__hercules_own_meta__"
+
+
+def _own_dict(target: type) -> dict:
+    # Only create/return the dict that belongs to ``target`` itself, never an
+    # inherited one — mirrors ``Reflect.getOwnMetadata`` semantics.
+    if _OWN not in target.__dict__:
+        setattr(target, _OWN, {})
+    return target.__dict__[_OWN]
+
+
+def define_metadata(key: str, value: Any, target: type) -> None:
+    _own_dict(target)[key] = value
+
+
+def get_own_metadata(key: str, target: type, default: Any = None) -> Any:
+    own = target.__dict__.get(_OWN)
+    if own is None:
+        return default
+    return own.get(key, default)
+
+
+def get_metadata(key: str, target: type, default: Any = None) -> Any:
+    for klass in getattr(target, "__mro__", (target,)):
+        own = klass.__dict__.get(_OWN)
+        if own is not None and key in own:
+            return own[key]
+    return default