another-ayx-python-sdk 2.4.21__py3-none-any.whl → 2.4.22__py3-none-any.whl

build/lib/another_ayx_python_sdk/examples/AyxSdkMultiConnectionsMultiOutputAnchor/main.py

@@ -0,0 +1,102 @@
+# Copyright (C) 2022 Alteryx, Inc. All rights reserved.
+#
+# Licensed under the ALTERYX SDK AND API LICENSE AGREEMENT;
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.alteryx.com/alteryx-sdk-and-api-license-agreement
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Example multiple input connection anchor tool."""
+from typing import Dict, TYPE_CHECKING
+
+from another_ayx_python_sdk.core import PluginV2
+
+
+if TYPE_CHECKING:
+    import pyarrow as pa
+    from another_ayx_python_sdk.providers.amp_provider.amp_provider_v2 import AMPProviderV2
+    from another_ayx_python_sdk.core.constants import Anchor
+
+
+class AyxSdkMultiConnectionsMultiOutputAnchor(PluginV2):
+    """Concrete implementation of an AyxPlugin."""
+
+    def __init__(self, provider: "AMPProviderV2") -> None:
+        """Construct a plugin."""
+        self.provider = provider
+        self.provider.io.info("Plugin initialized.")
+        try:
+            self.conn_to_output = self.get_conn_map()
+        except Exception as e:
+            self.provider.io.error(f"Failed to set conn map {repr(e)}")
+
+    def get_conn_map(self) -> Dict[str, str]:
+        """Map the connections of Input anchor to Output anchors."""
+        connections = self.provider.incoming_anchors["Input"].keys()
+        conn_to_output = {}
+        for name in connections:
+            conn_num = int(name.strip("#"))
+            if conn_num >= 5:
+                # Add any additional input to the last existing anchor.
+                conn_to_output[name] = f"Output5"
+            else:
+                conn_to_output[name] = f"Output{conn_num}"
+        return conn_to_output
+
+    def on_incoming_connection_complete(self, anchor: "Anchor") -> None:
+        """
+        Call when an incoming connection is done sending data including when no data is sent on an optional input anchor.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        anchor
+            NamedTuple containing anchor.name and anchor.connection.
+        """
+        self.provider.io.info(
+            f"Received complete update from {anchor.name}:{anchor.connection}."
+        )
+
+    def on_record_batch(self, table: "pa.Table", anchor: "Anchor") -> None:
+        """
+        Process the passed record batch.
+
+        The method that gets called whenever the plugin receives a record batch on an input.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        batch
+            A pyarrow Table containing the received batch.
+        anchor
+            A namedtuple('Anchor', ['name', 'connection']) containing input connection identifiers.
+        """
+        try:
+            out_anchor = self.conn_to_output[anchor.connection]
+            self.provider.write_to_anchor(out_anchor, table)
+        except Exception as e:
+            self.provider.io.warn(
+                f"Failed to write batch to output anchor. \n{repr(e)}"
+            )
+
+    def on_complete(self) -> None:
+        """
+        Clean up any plugin resources, or push records for an input tool.
+
+        This method gets called when all other plugin processing is complete.
+
+        In this method, a Plugin designer should perform any cleanup for their plugin.
+        However, if the plugin is an input-type tool (it has no incoming connections),
+        processing (record generation) should occur here.
+
+        Note: A tool with an optional input anchor and no incoming connections should
+        also write any records to output anchors here.
+        """
+        self.provider.io.info("AyxSdkMultiConnectionsMultiOutputAnchor tool done.")

build/lib/another_ayx_python_sdk/examples/AyxSdkMultipleInputAnchors/main.py

@@ -0,0 +1,84 @@
+# Copyright (C) 2022 Alteryx, Inc. All rights reserved.
+#
+# Licensed under the ALTERYX SDK AND API LICENSE AGREEMENT;
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.alteryx.com/alteryx-sdk-and-api-license-agreement
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Example multiple input anchor tool."""
+from typing import TYPE_CHECKING
+
+from another_ayx_python_sdk.core import PluginV2
+
+if TYPE_CHECKING:
+    from another_ayx_python_sdk.providers.amp_provider.amp_provider_v2 import AMPProviderV2
+    import pyarrow as pa
+    from another_ayx_python_sdk.core.constants import Anchor
+
+
+class AyxSdkMultipleInputAnchors(PluginV2):
+    """Concrete implementation of an AyxPlugin."""
+
+    def __init__(self, provider: "AMPProviderV2") -> None:
+        """Construct a plugin."""
+        self.provider = provider
+        self.output_anchor_name = "Output"
+        self.provider.io.info("Plugin initialized.")
+
+    def on_incoming_connection_complete(self, anchor: "Anchor") -> None:
+        """
+        Call when an incoming connection is done sending data including when no data is sent on an optional input anchor.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        anchor
+            NamedTuple containing anchor.name and anchor.connection.
+        """
+        self.provider.io.info(
+            f"Received complete update from {anchor.name}:{anchor.connection}."
+        )
+
+    def on_record_batch(self, table: "pa.Table", anchor: "Anchor") -> None:
+        """
+        Process the passed record batch.
+
+        The method that gets called whenever the plugin receives a record batch on an input.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        batch
+            A pyarrow Table containing the received batch.
+        anchor
+            A namedtuple('Anchor', ['name', 'connection']) containing input connection identifiers.
+        """
+        try:
+            self.provider.write_to_anchor(self.output_anchor_name, table)
+        except Exception as e:
+            self.provider.io.warn(
+                f"Error Occured while writing to anchor {anchor.name} \n {repr(e)}"
+            )
+
+    def on_complete(self) -> None:
+        """
+        Clean up any plugin resources, or push records for an input tool.
+
+        This method gets called when all other plugin processing is complete.
+
+        In this method, a Plugin designer should perform any cleanup for their plugin.
+        However, if the plugin is an input-type tool (it has no incoming connections),
+        processing (record generation) should occur here.
+
+        Note: A tool with an optional input anchor and no incoming connections should
+        also write any records to output anchors here.
+        """
+        self.provider.io.info("AyxSdkMultipleInputAnchors tool done.")

build/lib/another_ayx_python_sdk/examples/AyxSdkMultipleOutputAnchors/main.py

@@ -0,0 +1,96 @@
+# Copyright (C) 2022 Alteryx, Inc. All rights reserved.
+#
+# Licensed under the ALTERYX SDK AND API LICENSE AGREEMENT;
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.alteryx.com/alteryx-sdk-and-api-license-agreement
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Example pass through tool."""
+from another_ayx_python_sdk.core import (
+    Anchor,
+    PluginV2,
+)
+from another_ayx_python_sdk.providers.amp_provider.amp_provider_v2 import AMPProviderV2
+
+from pandas.core.dtypes.common import is_integer_dtype
+
+from pyarrow import RecordBatch, Table
+
+
+class AyxSdkMultipleOutputAnchors(PluginV2):
+    """A sample Plugin that filters numeric data for odd and even values."""
+
+    def __init__(self, provider: "AMPProviderV2"):
+        """Construct the plugin."""
+        self.provider = provider
+        self.provider.io.info("AyxSdkMultipleOutputAnchors tool started.")
+
+    def on_record_batch(self, batch: "Table", anchor: "Anchor") -> None:
+        """
+        Process the passed record batch.
+
+        The method that gets called whenever the plugin receives a record batch on an input.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        batch
+            A pyarrow Table containing the received batch.
+        anchor
+            A namedtuple('Anchor', ['name', 'connection']) containing input connection identifiers.
+        """
+        metadata = batch.schema
+        if not any([field_name == "Value" for field_name in metadata.names]):
+            raise RuntimeError(
+                "Incoming data must contain a column with the name 'Value'"
+            )
+        input_dataframe = batch.to_pandas()
+
+        if not is_integer_dtype(input_dataframe["Value"]):
+            raise RuntimeError("'Value' column must be of 'int' data type")
+
+        grouped = input_dataframe.groupby("Value")
+        odds = grouped.filter(lambda row: (row["Value"] % 2 == 1).any())
+        evens = grouped.filter(lambda row: (row["Value"] % 2 == 0).any())
+
+        odd_batch = RecordBatch.from_pandas(odds, preserve_index=False)
+        even_batch = RecordBatch.from_pandas(evens, preserve_index=False)
+        self.provider.write_to_anchor("Output1", odd_batch)
+        self.provider.write_to_anchor("Output2", even_batch)
+
+    def on_incoming_connection_complete(self, anchor: "Anchor") -> None:
+        """
+        Call when an incoming connection is done sending data including when no data is sent on an optional input anchor.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        anchor
+            NamedTuple containing anchor.name and anchor.connection.
+        """
+        self.provider.io.info(
+            f"Received complete update from {anchor.name}:{anchor.connection}."
+        )
+
+    def on_complete(self) -> None:
+        """
+        Clean up any plugin resources, or push records for an input tool.
+
+        This method gets called when all other plugin processing is complete.
+
+        In this method, a Plugin designer should perform any cleanup for their plugin.
+        However, if the plugin is an input-type tool (it has no incoming connections),
+        processing (record generation) should occur here.
+
+        Note: A tool with an optional input anchor and no incoming connections should
+        also write any records to output anchors here.
+        """
+        self.provider.io.info("AyxSdkMultipleOutputAnchors tool done.")

build/lib/another_ayx_python_sdk/examples/AyxSdkOptionalInputAnchor/main.py

@@ -0,0 +1,94 @@
+# Copyright (C) 2022 Alteryx, Inc. All rights reserved.
+#
+# Licensed under the ALTERYX SDK AND API LICENSE AGREEMENT;
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.alteryx.com/alteryx-sdk-and-api-license-agreement
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Example optional input anchor tool."""
+from typing import TYPE_CHECKING
+
+from another_ayx_python_sdk.core import PluginV2
+
+import pyarrow as pa
+
+if TYPE_CHECKING:
+    from another_ayx_python_sdk.providers.amp_provider.amp_provider_v2 import AMPProviderV2
+    from another_ayx_python_sdk.core.constants import Anchor
+
+
+class AyxSdkOptionalInputAnchor(PluginV2):
+    """Concrete implementation of an AyxPlugin."""
+
+    def __init__(self, provider: "AMPProviderV2") -> None:
+        """Construct a plugin."""
+        self.provider = provider
+        self.config_value = 0.42
+        self.output_anchor = self.provider.outgoing_anchors["Output"]
+        self.input_anchor = self.provider.incoming_anchors["Input"]
+        self.provider.io.info("Plugin initialized.")
+
+    def on_incoming_connection_complete(self, anchor: "Anchor") -> None:
+        """
+        Call when an incoming connection is done sending data including when no data is sent on an optional input anchor.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        anchor
+            NamedTuple containing anchor.name and anchor.connection.
+        """
+        self.provider.io.info(
+            f"Received complete update from {anchor.name}:{anchor.connection}."
+        )
+
+    def on_record_batch(self, batch: "pa.Table", anchor: "Anchor") -> None:
+        """
+        Process the passed record batch.
+
+        The method that gets called whenever the plugin receives a record batch on an input.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        batch
+            A pyarrow Table containing the received batch.
+        anchor
+            A namedtuple('Anchor', ['name', 'connection']) containing input connection identifiers.
+        """
+        try:
+            self.provider.write_to_anchor("Output", batch)
+        except Exception as e:
+            self.provider.io.warn(
+                f"Error Occured while writing to anchor {anchor.name} \n {repr(e)}"
+            )
+
+    def on_complete(self) -> None:
+        """
+        Clean up any plugin resources, or push records for an input tool.
+
+        This method gets called when all other plugin processing is complete.
+
+        In this method, a Plugin designer should perform any cleanup for their plugin.
+        However, if the plugin is an input-type tool (it has no incoming connections),
+        processing (record generation) should occur here.
+
+        Note: A tool with an optional input anchor and no incoming connections should
+        also write any records to output anchors here.
+        """
+        if len(self.input_anchor.keys()) == 0:
+            import pandas as pd
+
+            df = pd.DataFrame({"OptionalField": [self.config_value]})
+            batch_to_send = pa.RecordBatch.from_pandas(df=df, preserve_index=False)
+            self.provider.write_to_anchor("Output", batch_to_send)
+
+        self.provider.io.info("AyxSdkOptionalInputAnchor tool done.")

build/lib/another_ayx_python_sdk/examples/AyxSdkOutput/main.py

@@ -0,0 +1,78 @@
+# Copyright (C) 2022 Alteryx, Inc. All rights reserved.
+#
+# Licensed under the ALTERYX SDK AND API LICENSE AGREEMENT;
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.alteryx.com/alteryx-sdk-and-api-license-agreement
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Example output tool."""
+
+from another_ayx_python_sdk.core import (
+    Anchor,
+    PluginV2,
+)
+from another_ayx_python_sdk.providers.amp_provider.amp_provider_v2 import AMPProviderV2
+
+import pyarrow as pa
+
+
+class AyxSdkOutput(PluginV2):
+    """A sample Plugin that passes data from an input connection to an output connection."""
+
+    def __init__(self, provider: AMPProviderV2):
+        """Construct a plugin."""
+        self.provider = provider
+        self.provider.io.info("AyxSdkOutput tool started")
+
+    def on_record_batch(self, batch: "pa.Table", anchor: Anchor) -> None:
+        """
+        Process the passed record batch.
+
+        The method that gets called whenever the plugin receives a record batch on an input.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        batch
+            A pyarrow Table containing the received batch.
+        anchor
+            A namedtuple('Anchor', ['name', 'connection']) containing input connection identifiers.
+        """
+        self.provider.io.info(batch.to_string().replace("\n", " | "))
+
+    def on_incoming_connection_complete(self, anchor: Anchor) -> None:
+        """
+        Call when an incoming connection is done sending data including when no data is sent on an optional input anchor.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        anchor
+            NamedTuple containing anchor.name and anchor.connection.
+        """
+        self.provider.io.info(
+            f"Received complete update from {anchor.name}:{anchor.connection}."
+        )
+
+    def on_complete(self) -> None:
+        """
+        Clean up any plugin resources, or push records for an input tool.
+
+        This method gets called when all other plugin processing is complete.
+
+        In this method, a Plugin designer should perform any cleanup for their plugin.
+        However, if the plugin is an input-type tool (it has no incoming connections),
+        processing (record generation) should occur here.
+
+        Note: A tool with an optional input anchor and no incoming connections should
+        also write any records to output anchors here.
+        """
+        self.provider.io.info(f"AyxSdkOutput tool done.")

build/lib/another_ayx_python_sdk/examples/AyxSdkPassThrough/main.py

@@ -0,0 +1,82 @@
+# Copyright (C) 2022 Alteryx, Inc. All rights reserved.
+#
+# Licensed under the ALTERYX SDK AND API LICENSE AGREEMENT;
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.alteryx.com/alteryx-sdk-and-api-license-agreement
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Example pass through tool."""
+from typing import TYPE_CHECKING
+
+from another_ayx_python_sdk.core import (
+    Anchor,
+    PluginV2,
+)
+from another_ayx_python_sdk.providers.amp_provider.amp_provider_v2 import AMPProviderV2
+
+if TYPE_CHECKING:
+    import pyarrow as pa
+
+
+class AyxSdkPassThrough(PluginV2):
+    """A sample Plugin that passes data from an input connection to an output connection."""
+
+    def __init__(self, provider: AMPProviderV2):
+        """Construct the plugin."""
+        self.name = "AyxSdkPassThrough"
+        self.provider = provider
+        self.provider.io.info(f"{self.name} tool started")
+
+    def on_record_batch(self, batch: "pa.Table", anchor: Anchor) -> None:
+        """
+        Process the passed record batch.
+
+        The method that gets called whenever the plugin receives a record batch on an input.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        batch
+            A pyarrow Table containing the received batch.
+        anchor
+            A namedtuple('Anchor', ['name', 'connection']) containing input connection identifiers.
+        """
+        self.provider.write_to_anchor("Output", batch)
+
+    def on_incoming_connection_complete(self, anchor: Anchor) -> None:
+        """
+        Call when an incoming connection is done sending data including when no data is sent on an optional input anchor.
+
+        This method IS NOT called during update-only mode.
+
+        Parameters
+        ----------
+        anchor
+            NamedTuple containing anchor.name and anchor.connection.
+        """
+        self.provider.io.info(
+            f"Received complete update from {anchor.name}:{anchor.connection}."
+        )
+
+    def on_complete(self) -> None:
+        """
+        Clean up any plugin resources, or push records for an input tool.
+
+        This method gets called when all other plugin processing is complete.
+
+        In this method, a Plugin designer should perform any cleanup for their plugin.
+        However, if the plugin is an input-type tool (it has no incoming connections),
+        processing (record generation) should occur here.
+
+        Note: A tool with an optional input anchor and no incoming connections should
+        also write any records to output anchors here.
+        """
+        self.provider.io.info(f"{self.name} tool done.")

build/lib/another_ayx_python_sdk/providers/__init__.py

@@ -0,0 +1,14 @@
+# Copyright (C) 2022 Alteryx, Inc. All rights reserved.
+#
+# Licensed under the ALTERYX SDK AND API LICENSE AGREEMENT;
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.alteryx.com/alteryx-sdk-and-api-license-agreement
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Alteryx Python SDK: RecordProviders."""

build/lib/another_ayx_python_sdk/providers/amp_provider/__init__.py

@@ -0,0 +1,41 @@
+# Copyright (C) 2022 Alteryx, Inc. All rights reserved.
+#
+# Licensed under the ALTERYX SDK AND API LICENSE AGREEMENT;
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.alteryx.com/alteryx-sdk-and-api-license-agreement
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Alteryx Python SDK: AMP Provider."""
+
+from .amp_environment import AMPEnvironment
+from .amp_environment_v2 import AMPEnvironmentV2
+from .amp_input_anchor import AMPInputAnchor
+from .amp_input_connection import AMPInputConnection
+from .amp_driver import AMPDriver  # noqa: I100
+from .amp_io import AMPIO
+from .amp_io_components import ControlIOBuffer, StreamIOBuffer
+from .amp_output_anchor import AMPOutputAnchor
+from .amp_provider import AMPProvider
+from .amp_provider_v2 import AMPProviderV2
+from .amp_record_packet import AMPRecordPacket
+
+__all__ = [
+    "ControlIOBuffer",
+    "StreamIOBuffer",
+    "AMPDriver",
+    "AMPEnvironment",
+    "AMPEnvironmentV2",
+    "AMPInputAnchor",
+    "AMPInputConnection",
+    "AMPIO",
+    "AMPOutputAnchor",
+    "AMPProvider",
+    "AMPProviderV2",
+    "AMPRecordPacket",
+]

build/lib/another_ayx_python_sdk/providers/amp_provider/__main__.py

@@ -0,0 +1,85 @@
+# Copyright (C) 2022 Alteryx, Inc. All rights reserved.
+#
+# Licensed under the ALTERYX SDK AND API LICENSE AGREEMENT;
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#    https://www.alteryx.com/alteryx-sdk-and-api-license-agreement
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""Entrypoint for tracer bullet application."""
+import asyncio
+import logging
+
+from another_ayx_python_sdk.providers.amp_provider.amp_driver import AMPDriver
+from another_ayx_python_sdk.providers.amp_provider.logger_config import configure_logger
+from another_ayx_python_sdk.providers.amp_provider.plugin_class_loader import load_plugin_class
+from another_ayx_python_sdk.providers.amp_provider.sdk_tool_runner import SdkToolRunner
+
+
+import typer
+
+app = typer.Typer()
+
+
+@app.command()
+def version() -> None:
+    """Get the version of the CLI."""
+    typer.echo("Version 1.0.0")
+
+
+@app.command()
+def start_sdk_tool_service(
+    plugins_package: str,
+    tool_name: str,
+    sdk_engine_server_address: str = "localhost:6500",
+) -> None:
+    """Start the SDK Tool service."""
+    configure_logger()
+    logger = logging.getLogger()
+    try:
+        _log_info(f"Starting {tool_name} tool with AMP Provider.")
+        driver = AMPDriver()
+        # Could conditionally load Plugin V1 or V2 here if found necessary
+        plugin_class = load_plugin_class(plugins_package, tool_name)
+        driver._plugin_class = plugin_class
+
+        runner = SdkToolRunner(
+            sdk_engine_server_address  # SocketAddress.from_address_str(sdk_engine_server_address)
+        )
+        try:
+            asyncio.get_event_loop().run_until_complete(runner.start_service())
+        except Exception as e:
+            _log_error(f"ERROR: Couldn't start service.")
+            logger.exception(e)
+            raise typer.Exit(code=1)
+        _log_info("Exiting process")
+    except Exception as e:
+        typer.echo(f"EXCEPTION: {e}")
+        logger.exception(e)
+        raise
+
+
+def _log_info(msg: str) -> None:
+    logger = logging.getLogger()
+    logger.info("INFO: %s", msg)
+    typer.echo(f"INFO: {msg}")
+
+
+def _log_error(msg: str) -> None:
+    logger = logging.getLogger()
+    logger.error("ERROR: %s", msg)
+    typer.echo(f"ERROR: {msg}")
+
+
+def main() -> None:
+    """Entrypoint method for the tracer bullet application."""
+    app()
+
+
+if __name__ == "__main__":
+    main()