flowstash-cli 0.2.5__tar.gz → 0.2.6__tar.gz

{flowstash_cli-0.2.5 → flowstash_cli-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: flowstash-cli
-Version: 0.2.5
+Version: 0.2.6
 Summary: CLI for the flowstash Managed Platform
 Author: juraj.bezdek@gmail.com
 Author-email: juraj.bezdek@gmail.com
@@ -9,7 +9,7 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: flowstash-runtime (>=0.2.5,<0.3.0)
+Requires-Dist: flowstash-runtime (>=0.2.6,<0.3.0)
 Requires-Dist: httpx (>=0.27.0)
 Requires-Dist: keyring (>=25.0.0)
 Requires-Dist: libcst (>=1.1.0)

{flowstash_cli-0.2.5 → flowstash_cli-0.2.6}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "flowstash-cli"
-version = "0.2.5"
+version = "0.2.6"
 description = "CLI for the flowstash Managed Platform"
 authors = [{name = "juraj.bezdek@gmail.com", email = "juraj.bezdek@gmail.com"}]
 requires-python = ">=3.11"
 dependencies = [
-    "flowstash-runtime>=0.2.5,<0.3.0",
+    "flowstash-runtime>=0.2.6,<0.3.0",
     "typer[all]>=0.12.0",
     "httpx>=0.27.0",
     "pyyaml>=6.0.1",

{flowstash_cli-0.2.5 → flowstash_cli-0.2.6}/src/flowstash/cli/templates/AGENTS.md

@@ -111,11 +111,15 @@ with integration_context(integration="my-int", integration_pipeline="pipe"):
 
 ## Making External Requests: Clients
 
-flowstash makes it easy to interact with external APIs via Clients. They handle setting Base URLs, automatic Authentication headers, observability tracing, and defaults out of the box.
+flowstash makes it easy to interact with external APIs via Clients. **All client behavior—including authentication, base URLs, and retries—is driven by YAML configuration files.** This approach ensures that sensitive credentials and environment-specific settings are kept out of your code.
 
 ### Adding a Client
 
-To configure a new REST client, you place a configuration file (like `slackClient.yaml`) in your shared clients folder. flowstash dynamically loads these clients if your configuration registry points to the folder.
+To use a client, you **must first** define its configuration in a YAML file (e.g., `config/shared/clients/slackClient.yaml`). flowstash uses these files to determine the base URL, authentication, and retry logic.
+
+> [!IMPORTANT]
+> **The Configuration File is Mandatory.**
+> Every client you use via `get_client("myClient")` **must** have a corresponding configuration file. Without it, the client cannot be resolved. The name you pass to `get_client` must match either the filename (without extension) or the `client_id` specified inside the file.
 
 #### The `clients.yaml` Pointer
 The `clients.yaml` file in your shared configuration folder tells flowstash where to find your client definitions. Its schema is defined by `ClientsConfigPointer` in `flowstash.config.runtime_config`:
@@ -167,7 +171,7 @@ Once configured, you can retrieve the standard HTTP client (from the `flowstash.
 from flowstash.clients import get_client
 from flowstash.decorators import integration_task
 
-# Load the client configuration
+# Resolves the client named "slackClient" (expects slackClient.yaml configuration)
 slack_client = get_client("slackClient")
 
 @integration_task(integration="slack", integration_pipeline="send_message")

{flowstash_cli-0.2.5 → flowstash_cli-0.2.6}/src/flowstash/cli/templates/_api_main.py

@@ -8,7 +8,7 @@ env = os.getenv("ENVIRONMENT", "dev")
 config = load_config_dir("config", environment=env)
 
 # Create FastAPI app
-app = create_fastapi_app(config, auto_import=[Path(__file__).parent / "src" / "api" / "routes" / "webhooks.py"])
+app = create_fastapi_app(config, auto_import=[Path(__file__).parent / "src" / "api" / "routes" ])
 
 @app.get("/health")
 async def health():

{flowstash_cli-0.2.5 → flowstash_cli-0.2.6}/src/flowstash/cli/templates/_src/_worker/tasks/tasks.py

@@ -4,12 +4,12 @@ from flowstash.queue.backend import Schedule
 
 
 
-@integration_task(integration="demo", integration_pipeline="demo", default_schedule=Schedule(cron="* * * * *"))
-def demo_task(user_id: int):
+@integration_task(integration="demo", integration_pipeline="demo", default_schedule=Schedule(cron="0 0 * * 0"))
+def demo_task():
     """
-    Task to process a user by ID.
+    Demo task to be executed weekly.
     """
-    print(f"Processing user {user_id}...")
+    print(f"Processing user...")