From f97b071976db89946e1b86df9f3e08317171fb9c Mon Sep 17 00:00:00 2001
From: Hency Raj <hencyraj21@gmail.com>
Date: Sun, 11 Jan 2026 21:14:43 +0530
Subject: [PATCH] examples: add README and improve error handling in
 apply_from_dict

---
 examples/README.md          | 12 ++++++++++++
 examples/apply_from_dict.py | 15 +++++++++++++--
 2 files changed, 25 insertions(+), 2 deletions(-)

diff --git a/examples/README.md b/examples/README.md
index 618e840ea3..d84c633ae2 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -15,3 +15,15 @@ installed following the directions
 
 If you find a problem please file an
 [issue](https://github.com/kubernetes-client/python/issues).
+
+
+---
+
+## Running Examples Locally
+
+### Prerequisites
+
+- Python 3.8 or newer
+- Kubernetes Python client installed:
+  ```bash
+  pip install kubernetes
diff --git a/examples/apply_from_dict.py b/examples/apply_from_dict.py
index 9c0ac81242..972d42529d 100644
--- a/examples/apply_from_dict.py
+++ b/examples/apply_from_dict.py
@@ -1,3 +1,7 @@
+import sys
+from kubernetes.client.rest import ApiException
+
+
 from kubernetes import client, config, utils
 def main():
     config.load_kube_config()
@@ -6,5 +10,12 @@ def main():
     example_dict = {'apiVersion': 'apps/v1', 'kind': 'Deployment', 'metadata': {'name': 'k8s-py-client-nginx'}, 'spec': {'selector': {'matchLabels': {'app': 'nginx'}}, 'replicas': 1, 'template': {'metadata': {'labels': {'app': 'nginx'}}, 'spec': {'containers': [{'name': 'nginx', 'image': 'nginx:1.14.2', 'ports': [{'containerPort': 80}]}]}}}}
     utils.create_from_dict(k8s_client, example_dict)
 
-if __name__ == '__main__':
-    main()
\ No newline at end of file
+if __name__ == "__main__":
+    try:
+        main()
+    except ApiException as e:
+        print(f"Kubernetes API error: {e}", file=sys.stderr)
+        sys.exit(1)
+    except Exception as e:
+        print(f"Unexpected error: {e}", file=sys.stderr)
+        sys.exit(2)