garf-executors 0.2.2__tar.gz → 1.0.2__tar.gz

{garf_executors-0.2.2 → garf_executors-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: garf-executors
-Version: 0.2.2
+Version: 1.0.2
 Summary: Executes queries against API and writes data to local/remote storage.
 Author-email: "Google Inc. (gTech gPS CSE team)" <no-reply@google.com>, Andrei Markin <andrey.markin.ppc@gmail.com>
 License: Apache 2.0
@@ -17,8 +17,8 @@ Classifier: Operating System :: OS Independent
 Classifier: License :: OSI Approved :: Apache Software License
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
-Requires-Dist: garf-core
-Requires-Dist: garf-io
+Requires-Dist: garf-core>=1.0.0
+Requires-Dist: garf-io>=1.0.0
 Requires-Dist: pyyaml
 Requires-Dist: pydantic
 Requires-Dist: opentelemetry-api
@@ -28,15 +28,18 @@ Provides-Extra: bq
 Requires-Dist: garf-io[bq]; extra == "bq"
 Requires-Dist: pandas; extra == "bq"
 Requires-Dist: google-cloud-logging; extra == "bq"
+Requires-Dist: smart_open[gcs]; extra == "bq"
 Provides-Extra: sql
 Requires-Dist: garf-io[sqlalchemy]; extra == "sql"
 Requires-Dist: pandas; extra == "sql"
+Provides-Extra: gcp
+Requires-Dist: opentelemetry-exporter-gcp-trace; extra == "gcp"
 Provides-Extra: server
 Requires-Dist: fastapi[standard]; extra == "server"
 Requires-Dist: opentelemetry-instrumentation-fastapi; extra == "server"
 Requires-Dist: typer; extra == "server"
 Provides-Extra: all
-Requires-Dist: garf-executors[bq,server,sql]; extra == "all"
+Requires-Dist: garf-executors[bq,gcp,server,sql]; extra == "all"
 
 # `garf-executors` - One stop-shop for interacting with Reporting APIs.
 
@@ -65,8 +68,14 @@ garf <QUERIES> --source <API_SOURCE> \
 where
 
 * `<QUERIES>`- local or remote path(s) to files with queries.
-* `<API_SOURCE>`- type of API to use. Based on that the appropriate report fetcher will be initialized.
-* `<OUTPUT_TYPE>` - output supported by [`garf-io` library](../garf_io/README.md).
+* `source`- type of API to use. Based on that the appropriate report fetcher will be initialized. Explore supported APIs [here](https://google.github.io/garf/fetchers/overview/)
+* `output` - output supported by [`garf-io` library](https://google.github.io/garf/usage/writers/).
 
 If your report fetcher requires additional parameters you can pass them via key value pairs under `--source.` argument, i.e.`--source.regionCode='US'` - to get data only from *US*.
 > Concrete `--source` parameters are dependent on a particular report fetcher and should be looked up in a documentation for this fetcher.
+
+## Documentation
+
+Explore full documentation working with `garf-executors`
+
+* [Documentation](https://google.github.io/garf/usage/executors/)

{garf_executors-0.2.2 → garf_executors-1.0.2}/README.md

@@ -25,8 +25,14 @@ garf <QUERIES> --source <API_SOURCE> \
 where
 
 * `<QUERIES>`- local or remote path(s) to files with queries.
-* `<API_SOURCE>`- type of API to use. Based on that the appropriate report fetcher will be initialized.
-* `<OUTPUT_TYPE>` - output supported by [`garf-io` library](../garf_io/README.md).
+* `source`- type of API to use. Based on that the appropriate report fetcher will be initialized. Explore supported APIs [here](https://google.github.io/garf/fetchers/overview/)
+* `output` - output supported by [`garf-io` library](https://google.github.io/garf/usage/writers/).
 
 If your report fetcher requires additional parameters you can pass them via key value pairs under `--source.` argument, i.e.`--source.regionCode='US'` - to get data only from *US*.
 > Concrete `--source` parameters are dependent on a particular report fetcher and should be looked up in a documentation for this fetcher.
+
+## Documentation
+
+Explore full documentation working with `garf-executors`
+
+* [Documentation](https://google.github.io/garf/usage/executors/)

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/__init__.py

@@ -17,9 +17,9 @@ from __future__ import annotations
 
 import importlib
 
-from garf_executors import executor, fetchers
-from garf_executors.api_executor import ApiExecutionContext, ApiQueryExecutor
-from garf_executors.telemetry import tracer
+from garf.executors import executor, fetchers
+from garf.executors.api_executor import ApiExecutionContext, ApiQueryExecutor
+from garf.executors.telemetry import tracer
 
 
 @tracer.start_as_current_span('setup_executor')
@@ -31,10 +31,10 @@ def setup_executor(
 ) -> type[executor.Executor]:
   """Initializes executors based on a source and parameters."""
   if source == 'bq':
-    bq_executor = importlib.import_module('garf_executors.bq_executor')
+    bq_executor = importlib.import_module('garf.executors.bq_executor')
     query_executor = bq_executor.BigQueryExecutor(**fetcher_parameters)
   elif source == 'sqldb':
-    sql_executor = importlib.import_module('garf_executors.sql_executor')
+    sql_executor = importlib.import_module('garf.executors.sql_executor')
     query_executor = (
       sql_executor.SqlAlchemyQueryExecutor.from_connection_string(
         fetcher_parameters.get('connection_string')
@@ -57,4 +57,4 @@ __all__ = [
   'ApiExecutionContext',
 ]
 
-__version__ = '0.2.2'
+__version__ = '1.0.2'

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/api_executor.py

@@ -22,12 +22,17 @@ from __future__ import annotations
 
 import logging
 
-from garf_core import report_fetcher
+from garf.core import report_fetcher
+from garf.executors import (
+  exceptions,
+  execution_context,
+  executor,
+  fetchers,
+  query_processor,
+)
+from garf.executors.telemetry import tracer
 from opentelemetry import trace
 
-from garf_executors import exceptions, execution_context, executor, fetchers
-from garf_executors.telemetry import tracer
-
 logger = logging.getLogger(__name__)
 
 
@@ -95,6 +100,7 @@ class ApiQueryExecutor(executor.Executor):
     Raises:
       GarfExecutorError: When failed to execute query.
     """
+    context = query_processor.process_gquery(context)
     span = trace.get_current_span()
     span.set_attribute('fetcher.class', self.fetcher.__class__.__name__)
     span.set_attribute(

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/bq_executor.py

@@ -28,13 +28,12 @@ except ImportError as e:
 
 import logging
 
-from garf_core import query_editor, report
+from garf.core import query_editor, report
+from garf.executors import exceptions, execution_context, executor
+from garf.executors.telemetry import tracer
 from google.cloud import exceptions as google_cloud_exceptions
 from opentelemetry import trace
 
-from garf_executors import exceptions, execution_context, executor
-from garf_executors.telemetry import tracer
-
 logger = logging.getLogger(__name__)
 
 
@@ -55,6 +54,7 @@ class BigQueryExecutor(executor.Executor, query_editor.TemplateProcessorMixin):
     self,
     project_id: str | None = os.getenv('GOOGLE_CLOUD_PROJECT'),
     location: str | None = None,
+    **kwargs: str,
   ) -> None:
     """Initializes BigQueryExecutor.
 

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/config.py

@@ -24,8 +24,7 @@ import pathlib
 import pydantic
 import smart_open
 import yaml
-
-from garf_executors.execution_context import ExecutionContext
+from garf.executors.execution_context import ExecutionContext
 
 
 class Config(pydantic.BaseModel):

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/entrypoints/cli.py

@@ -21,17 +21,17 @@ from __future__ import annotations
 
 import argparse
 import logging
+import pathlib
 import sys
 
-from garf_io import reader
+import garf.executors
+from garf.executors import config, exceptions, workflow
+from garf.executors.entrypoints import utils
+from garf.executors.entrypoints.tracer import initialize_tracer
+from garf.executors.telemetry import tracer
+from garf.io import reader
 from opentelemetry import trace
 
-import garf_executors
-from garf_executors import config, exceptions, workflow
-from garf_executors.entrypoints import utils
-from garf_executors.entrypoints.tracer import initialize_tracer
-from garf_executors.telemetry import tracer
-
 initialize_tracer()
 
 
@@ -76,17 +76,18 @@ def main():
   command_args = ' '.join(sys.argv[1:])
   span.set_attribute('cli.command', f'garf {command_args}')
   if args.version:
-    print(garf_executors.__version__)
+    print(garf.executors.__version__)
     sys.exit()
   logger = utils.init_logging(
     loglevel=args.loglevel.upper(), logger_type=args.logger, name=args.log_name
   )
   reader_client = reader.create_reader(args.input)
   if workflow_file := args.workflow:
+    wf_parent = pathlib.Path.cwd() / pathlib.Path(workflow_file).parent
     execution_workflow = workflow.Workflow.from_file(workflow_file)
     for i, step in enumerate(execution_workflow.steps, 1):
       with tracer.start_as_current_span(f'{i}-{step.fetcher}'):
-        query_executor = garf_executors.setup_executor(
+        query_executor = garf.executors.setup_executor(
           source=step.fetcher,
           fetcher_parameters=step.fetcher_parameters,
           enable_cache=args.enable_cache,
@@ -99,8 +100,20 @@ def main():
             'Please provide one or more queries to run'
           )
         for query in queries:
-          if isinstance(query, garf_executors.workflow.QueryPath):
-            batch[query.path] = reader_client.read(query.path)
+          if isinstance(query, garf.executors.workflow.QueryPath):
+            query_path = wf_parent / pathlib.Path(query.path)
+            if not query_path.exists():
+              raise workflow.GarfWorkflowError(f'Query: {query_path} not found')
+            batch[query.path] = reader_client.read(query_path)
+          elif isinstance(query, garf.executors.workflow.QueryFolder):
+            query_path = wf_parent / pathlib.Path(query.folder)
+            if not query_path.exists():
+              raise workflow.GarfWorkflowError(
+                f'Folder: {query_path} not found'
+              )
+            for p in query_path.rglob('*'):
+              if p.suffix == '.sql':
+                batch[p.stem] = reader_client.read(p)
           else:
             batch[query.query.title] = query.query.text
         query_executor.execute_batch(
@@ -130,7 +143,7 @@ def main():
     for output in outputs:
       writer_parameters.update(extra_parameters.get(output))
 
-    context = garf_executors.api_executor.ApiExecutionContext(
+    context = garf.executors.api_executor.ApiExecutionContext(
       query_parameters={
         'macro': extra_parameters.get('macro'),
         'template': extra_parameters.get('template'),
@@ -139,7 +152,7 @@ def main():
       writer_parameters=writer_parameters,
       fetcher_parameters=source_parameters,
     )
-  query_executor = garf_executors.setup_executor(
+  query_executor = garf.executors.setup_executor(
     source=args.source,
     fetcher_parameters=context.fetcher_parameters,
     enable_cache=args.enable_cache,

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/entrypoints/grpc_server.py

@@ -18,21 +18,20 @@ import argparse
 import logging
 from concurrent import futures
 
+import garf.executors
 import grpc
+from garf.executors import garf_pb2, garf_pb2_grpc
+from garf.executors.entrypoints.tracer import initialize_tracer
 from google.protobuf.json_format import MessageToDict
 from grpc_reflection.v1alpha import reflection
 
-import garf_executors
-from garf_executors import garf_pb2, garf_pb2_grpc
-from garf_executors.entrypoints.tracer import initialize_tracer
-
 
 class GarfService(garf_pb2_grpc.GarfService):
   def Execute(self, request, context):
-    query_executor = garf_executors.setup_executor(
+    query_executor = garf.executors.setup_executor(
       request.source, request.context.fetcher_parameters
     )
-    execution_context = garf_executors.execution_context.ExecutionContext(
+    execution_context = garf.executors.execution_context.ExecutionContext(
       **MessageToDict(request.context, preserving_proto_field_name=True)
     )
     result = query_executor.execute(

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/entrypoints/server.py

@@ -17,17 +17,16 @@
 from typing import Optional, Union
 
 import fastapi
+import garf.executors
 import pydantic
 import typer
 import uvicorn
-from garf_io import reader
+from garf.executors import exceptions
+from garf.executors.entrypoints.tracer import initialize_tracer
+from garf.io import reader
 from opentelemetry.instrumentation.fastapi import FastAPIInstrumentor
 from typing_extensions import Annotated
 
-import garf_executors
-from garf_executors import exceptions
-from garf_executors.entrypoints.tracer import initialize_tracer
-
 initialize_tracer()
 app = fastapi.FastAPI()
 FastAPIInstrumentor.instrument_app(app)
@@ -49,7 +48,7 @@ class ApiExecutorRequest(pydantic.BaseModel):
   title: Optional[str] = None
   query: Optional[str] = None
   query_path: Optional[Union[str, list[str]]] = None
-  context: garf_executors.api_executor.ApiExecutionContext
+  context: garf.executors.api_executor.ApiExecutionContext
 
   @pydantic.model_validator(mode='after')
   def check_query_specified(self):
@@ -78,18 +77,18 @@ class ApiExecutorResponse(pydantic.BaseModel):
 
 @app.get('/api/version')
 async def version() -> str:
-  return garf_executors.__version__
+  return garf.executors.__version__
 
 
 @app.get('/api/fetchers')
 async def get_fetchers() -> list[str]:
   """Shows all available API sources."""
-  return list(garf_executors.fetchers.find_fetchers())
+  return list(garf.executors.fetchers.find_fetchers())
 
 
 @app.post('/api/execute')
 async def execute(request: ApiExecutorRequest) -> ApiExecutorResponse:
-  query_executor = garf_executors.setup_executor(
+  query_executor = garf.executors.setup_executor(
     request.source, request.context.fetcher_parameters
   )
   result = query_executor.execute(request.query, request.title, request.context)
@@ -98,7 +97,7 @@ async def execute(request: ApiExecutorRequest) -> ApiExecutorResponse:
 
 @app.post('/api/execute:batch')
 def execute_batch(request: ApiExecutorRequest) -> ApiExecutorResponse:
-  query_executor = garf_executors.setup_executor(
+  query_executor = garf.executors.setup_executor(
     request.source, request.context.fetcher_parameters
   )
   reader_client = reader.FileReader()

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/entrypoints/tracer.py

@@ -1,4 +1,4 @@
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -35,8 +35,23 @@ def initialize_tracer():
   tracer_provider = TracerProvider(resource=resource)
 
   if otel_endpoint := os.getenv('OTEL_EXPORTER_OTLP_ENDPOINT'):
-    otlp_processor = BatchSpanProcessor(
-      OTLPSpanExporter(endpoint=otel_endpoint, insecure=True)
-    )
-    tracer_provider.add_span_processor(otlp_processor)
+    if gcp_project_id := os.getenv('OTEL_EXPORTER_GCP_PROJECT_ID'):
+      try:
+        from opentelemetry.exporter.cloud_trace import CloudTraceSpanExporter
+      except ImportError as e:
+        raise ImportError(
+          'Please install garf-executors with GCP support '
+          '- `pip install garf-executors[gcp]`'
+        ) from e
+
+      cloud_span_processor = BatchSpanProcessor(
+        CloudTraceSpanExporter(project_id=gcp_project_id)
+      )
+      tracer_provider.add_span_processor(cloud_span_processor)
+    else:
+      otlp_processor = BatchSpanProcessor(
+        OTLPSpanExporter(endpoint=otel_endpoint, insecure=True)
+      )
+      tracer_provider.add_span_processor(otlp_processor)
+
   trace.set_tracer_provider(tracer_provider)

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/execution_context.py

@@ -20,13 +20,14 @@ from __future__ import annotations
 
 import os
 import pathlib
+from typing import Any
 
 import pydantic
 import smart_open
 import yaml
-from garf_core import query_editor
-from garf_io import writer
-from garf_io.writers import abs_writer
+from garf.core import query_editor
+from garf.io import writer
+from garf.io.writers import abs_writer
 
 
 class ExecutionContext(pydantic.BaseModel):
@@ -42,8 +43,8 @@ class ExecutionContext(pydantic.BaseModel):
   query_parameters: query_editor.GarfQueryParameters | None = pydantic.Field(
     default_factory=dict
   )
-  fetcher_parameters: dict[str, str | bool | int | list[str | int]] | None = (
-    pydantic.Field(default_factory=dict)
+  fetcher_parameters: dict[str, Any] | None = pydantic.Field(
+    default_factory=dict
   )
   writer: str | list[str] | None = None
   writer_parameters: dict[str, str] | None = pydantic.Field(

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/executor.py

@@ -18,12 +18,11 @@ import asyncio
 import inspect
 from typing import Optional
 
-from garf_core import report_fetcher
+from garf.core import report_fetcher
+from garf.executors import execution_context, query_processor
+from garf.executors.telemetry import tracer
 from opentelemetry import trace
 
-from garf_executors import execution_context
-from garf_executors.telemetry import tracer
-
 
 class Executor:
   """Defines common functionality between executors."""
@@ -113,6 +112,7 @@ def _handle_processors(
   processors: dict[str, report_fetcher.Processor],
   context: execution_context.ExecutionContext,
 ) -> None:
+  context = query_processor.process_gquery(context)
   for k, processor in processors.items():
     processor_signature = list(inspect.signature(processor).parameters.keys())
     if k in context.fetcher_parameters:

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/fetchers.py

@@ -17,11 +17,10 @@ import logging
 import sys
 from importlib.metadata import entry_points
 
-from garf_core import report_fetcher
+from garf.core import report_fetcher
+from garf.executors.telemetry import tracer
 
-from garf_executors.telemetry import tracer
-
-logger = logging.getLogger(name='garf_executors.fetchers')
+logger = logging.getLogger(name='garf.executors.fetchers')
 
 
 @tracer.start_as_current_span('find_fetchers')

garf_executors-1.0.2/garf/executors/query_processor.py

@@ -0,0 +1,61 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+import contextlib
+
+from garf.core import query_editor
+from garf.executors import exceptions, execution_context
+
+
+def process_gquery(
+  context: execution_context.ExecutionContext,
+) -> execution_context.ExecutionContext:
+  for k, v in context.fetcher_parameters.items():
+    if isinstance(v, str) and v.startswith('gquery'):
+      no_writer_context = context.model_copy(update={'writer': None})
+      try:
+        _, alias, query = v.split(':', maxsplit=3)
+      except ValueError:
+        raise exceptions.GarfExecutorError(
+          f'Incorrect gquery format, should be gquery:alias:query, got {v}'
+        )
+      if alias == 'sqldb':
+        from garf.executors import sql_executor
+
+        gquery_executor = sql_executor.SqlAlchemyQueryExecutor(
+          **context.fetcher_parameters
+        )
+      elif alias == 'bq':
+        from garf.executors import bq_executor
+
+        gquery_executor = bq_executor.BigQueryExecutor(
+          **context.fetcher_parameters
+        )
+      else:
+        raise exceptions.GarfExecutorError(
+          f'Unsupported alias for gquery: {alias}'
+        )
+      with contextlib.suppress(query_editor.GarfResourceError):
+        query_spec = query_editor.QuerySpecification(
+          text=query, args=context.query_parameters
+        ).generate()
+        if len(columns := [c for c in query_spec.column_names if c != '_']) > 1:
+          raise exceptions.GarfExecutorError(
+            f'Multiple columns in gquery: {columns}'
+          )
+      res = gquery_executor.execute(
+        query=query, title='gquery', context=no_writer_context
+      )
+      context.fetcher_parameters[k] = res.to_list(row_type='scalar')
+  return context

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/sql_executor.py

@@ -28,12 +28,11 @@ import re
 import uuid
 
 import pandas as pd
-from garf_core import query_editor, report
+from garf.core import query_editor, report
+from garf.executors import exceptions, execution_context, executor
+from garf.executors.telemetry import tracer
 from opentelemetry import trace
 
-from garf_executors import exceptions, execution_context, executor
-from garf_executors.telemetry import tracer
-
 logger = logging.getLogger(__name__)
 
 
@@ -50,24 +49,26 @@ class SqlAlchemyQueryExecutor(
       engine: Initialized Engine object to operated on a given database.
   """
 
-  def __init__(self, engine: sqlalchemy.engine.base.Engine) -> None:
+  def __init__(
+    self, engine: sqlalchemy.engine.base.Engine | None = None, **kwargs: str
+  ) -> None:
     """Initializes executor with a given engine.
 
     Args:
         engine: Initialized Engine object to operated on a given database.
     """
-    self.engine = engine
+    self.engine = engine or sqlalchemy.create_engine('sqlite://')
     super().__init__()
 
   @classmethod
   def from_connection_string(
-    cls, connection_string: str
+    cls, connection_string: str | None
   ) -> SqlAlchemyQueryExecutor:
     """Creates executor from SqlAlchemy connection string.
 
     https://docs.sqlalchemy.org/en/20/core/engines.html
     """
-    engine = sqlalchemy.create_engine(connection_string)
+    engine = sqlalchemy.create_engine(connection_string or 'sqlite://')
     return cls(engine)
 
   @tracer.start_as_current_span('sql.execute')

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/telemetry.py

@@ -16,5 +16,5 @@
 from opentelemetry import trace
 
 tracer = trace.get_tracer(
-  instrumenting_module_name='garf_executors',
+  instrumenting_module_name='garf.executors',
 )

{garf_executors-0.2.2/garf_executors → garf_executors-1.0.2/garf/executors}/workflow.py

@@ -19,8 +19,18 @@ import pathlib
 import pydantic
 import smart_open
 import yaml
+from garf.executors import exceptions
+from garf.executors.execution_context import ExecutionContext
 
-from garf_executors.execution_context import ExecutionContext
+
+class GarfWorkflowError(exceptions.GarfExecutorError):
+  """Workflow specific exception."""
+
+
+class QueryFolder(pydantic.BaseModel):
+  """Path to folder with queries."""
+
+  folder: str
 
 
 class QueryPath(pydantic.BaseModel):
@@ -58,8 +68,8 @@ class ExecutionStep(ExecutionContext):
   """
 
   fetcher: str | None = None
-  alias: str | None = None
-  queries: list[QueryPath | QueryDefinition] | None = None
+  alias: str | None = pydantic.Field(default=None, pattern=r'^[a-zA-Z0-9_]+$')
+  queries: list[QueryPath | QueryDefinition | QueryFolder] | None = None
 
   @property
   def context(self) -> ExecutionContext:
@@ -85,7 +95,10 @@ class Workflow(pydantic.BaseModel):
     """Builds workflow from local or remote yaml file."""
     with smart_open.open(path, 'r', encoding='utf-8') as f:
       data = yaml.safe_load(f)
-    return Workflow(steps=data.get('steps'))
+    try:
+      return Workflow(**data)
+    except pydantic.ValidationError as e:
+      raise GarfWorkflowError(f'Incorrect workflow:\n {e}') from e
 
   def save(self, path: str | pathlib.Path | os.PathLike[str]) -> str:
     """Saves workflow to local or remote yaml file."""

garf_executors-1.0.2/garf_executors/__init__.py

@@ -0,0 +1,25 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+
+import warnings
+
+from garf.executors import *
+
+warnings.warn(
+  "The 'garf_executors' namespace is deprecated. "
+  "Please use 'garf.executors' instead.",
+  DeprecationWarning,
+  stacklevel=2,
+)

garf_executors-1.0.2/garf_executors/api_executor.py

@@ -0,0 +1,25 @@
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# 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.
+
+
+import warnings
+
+from garf.executors.api_executor import *
+
+warnings.warn(
+  "The 'garf_executors' namespace is deprecated. "
+  "Please use 'garf.executors' instead.",
+  DeprecationWarning,
+  stacklevel=2,
+)