update sample

Author: THardy98

README.md

@@ -66,6 +66,7 @@ Some examples require extra dependencies. See each sample's directory for specif
 * [custom_metric](custom_metric) - Custom metric to record the workflow type in the activity schedule to start latency.
 * [dsl](dsl) - DSL workflow that executes steps defined in a YAML file.
 * [encryption](encryption) - Apply end-to-end encryption for all input/output.
+* [env_config](env_config) - Load client configuration from TOML files with programmatic overrides.
 * [gevent_async](gevent_async) - Combine gevent and Temporal.
 * [langchain](langchain) - Orchestrate workflows for LangChain.
 * [message_passing/introduction](message_passing/introduction/) - Introduction to queries, signals, and updates.

env_config/README.md

@@ -1,6 +1,6 @@
 # Temporal External Client Configuration Samples
 
-This directory contains Python samples that demonstrate how to use the Temporal SDK's external client configuration feature. This feature allows you to configure a `temporalio.client.Client` using a TOML file and/or environment variables, decoupling connection settings from your application code.
+This directory contains Python samples that demonstrate how to use the Temporal SDK's external client configuration feature. This feature allows you to configure a `temporalio.client.Client` using a TOML file and/or programmatic overrides, decoupling connection settings from your application code.
 
 ## Prerequisites
 
@@ -30,7 +30,7 @@ python3 env_config/load_default.py
 
 ### `load_profile.py`
 
-This sample demonstrates loading the `staging` profile by name (which has an incorrect address) and then correcting the address using an environment variable. This highlights how environment variables can be used to fix or override file-based configuration.
+This sample demonstrates loading the `staging` profile by name (which has an incorrect address) and then correcting the address programmatically. This highlights the recommended approach for overriding configuration values at runtime.
 
 **To run this sample:**
 

env_config/load_profile.py

@@ -1,6 +1,6 @@
 """
 This sample demonstrates loading a named environment configuration profile and
-overriding its values with environment variables.
+programmatically overriding its values.
 """
 
 import asyncio
@@ -12,37 +12,29 @@
 
 async def main():
     """
-    Demonstrates loading a named profile and overriding it with env vars.
+    Demonstrates loading a named profile and overriding values programmatically.
     """
-    print("--- Loading 'staging' profile with environment variable overrides ---")
+    print("--- Loading 'staging' profile with programmatic overrides ---")
 
     config_file = Path(__file__).parent / "config.toml"
     profile_name = "staging"
 
-    # In a real application, these would be set in your shell or deployment
-    # environment (e.g., `export TEMPORAL_ADDRESS=localhost:7233`).
-    # For this sample, we pass them as a dictionary to demonstrate.
-    override_env = {
-        "TEMPORAL_ADDRESS": "localhost:7233",
-    }
-    print("The 'staging' profile in config.toml has an incorrect address.")
-    print("Using mock environment variables to override and correct it:")
-    for key, value in override_env.items():
-        print(f"  {key}={value}")
-
-    # Load the 'staging' profile and apply environment variable overrides.
+    print("The 'staging' profile in config.toml has an incorrect address (localhost:9999).")
+    print("We'll programmatically override it to the correct address.")
+
+    # Load the 'staging' profile.
     connect_config = ClientConfig.load_client_connect_config(
         profile=profile_name,
         config_file=str(config_file),
-        override_env_vars=override_env,
     )
 
+    # Override the target host to the correct address.
+    # This is the recommended way to override configuration values.
+    connect_config["target_host"] = "localhost:7233"
+
     print(f"\nLoaded '{profile_name}' profile from {config_file} with overrides.")
-    print(f"  Address: {connect_config.get('target_host')}")
+    print(f"  Address: {connect_config.get('target_host')} (overridden from localhost:9999)")
     print(f"  Namespace: {connect_config.get('namespace')}")
-    print(
-        "\nNote how the incorrect address from the file was corrected by the env var."
-    )
 
     print("\nAttempting to connect to client...")
     try: