Merge changes for 2.3.0 release

README.md

@@ -21,6 +21,34 @@ This is an easy-to-use tutorial for accessing EVSRESTAPI APIs.
 - [Click for Python examples.](../master/python-examples/ "Python Examples")
 - [Click for Swagger API documentation](https://api-evsrest.nci.nih.gov/swagger-ui/index.html)
 
+## Automation scripts for examples
+
+A set of convenience scripts is provided in some of the example directories to help you run the example collections/tests and capture outputs quickly. These scripts are optional helpers and use the examples' local files and tooling.
+
+- `postman-examples/postman.sh` — Runs the Postman collection via Newman. Example:
+	```bash
+	cd postman-examples
+	./postman.sh
+	```
+- `fhir-examples/postman_fhir.sh` — Runs the FHIR collections (R4 or R5) via Newman. Example:
+	```bash
+	cd fhir-examples
+	./postman_fhir.sh R4
+	```
+	You can override the API URL used by these Postman scripts by setting the `API_URL` environment variable before running them.
+- `python-examples/python_check.py` — Scans `python-examples/README.md` for backticked pytest commands and runs them using your Python environment. Example:
+	```bash
+	cd python-examples
+	python python_check.py
+	```
+- `java-examples/java_check.py` — Scans `java-examples/README.md` for `./gradlew` commands, executes them, and writes captured outputs to the `samples/` folder. Example:
+	```bash
+	cd java-examples
+	python java_check.py
+	```
+
+Requirements: `newman` (npm) for Postman scripts; `pytest` (pip) for the Python helper; Java (JDK) and a working `./gradlew` (Gradle wrapper) for the Java helper.
+
 **[Back to top](#table-of-contents)**
 
 ## Use Cases

bash-examples/samples/find-concepts.txt

@@ -1,121 +1,121 @@
------------------------------------------------------
-Starting ...Wed, Mar 12, 2025  4:12:22 PM
------------------------------------------------------
-url = https://api-evsrest.nci.nih.gov/api/v1
-terminology = ncit
-term = malignant
-include = 
-
-  Find concepts for ncit malignant:
-
-    {
-      "total": 4676,
-      "timeTaken": 70,
-      "parameters": {
-        "term": "malignant",
-        "type": "contains",
-        "include": "minimal",
-        "fromRecord": 0,
-        "pageSize": 10,
-        "terminology": [
-          "ncit"
-        ]
-      },
-      "concepts": [
-        {
-          "code": "C14143",
-          "name": "Malignant",
-          "terminology": "ncit",
-          "version": "25.02d",
-          "conceptStatus": "DEFAULT",
-          "leaf": true,
-          "active": true
-        },
-        {
-          "code": "C7612",
-          "name": "Malignant Thymoma",
-          "terminology": "ncit",
-          "version": "25.02d",
-          "conceptStatus": "DEFAULT",
-          "leaf": false,
-          "active": true
-        },
-        {
-          "code": "C9305",
-          "name": "Malignant Neoplasm",
-          "terminology": "ncit",
-          "version": "25.02d",
-          "conceptStatus": "DEFAULT",
-          "leaf": false,
-          "active": true
-        },
-        {
-          "code": "C121792",
-          "name": "Malignant PEComa",
-          "terminology": "ncit",
-          "version": "25.02d",
-          "conceptStatus": "DEFAULT",
-          "leaf": false,
-          "active": true
-        },
-        {
-          "code": "C65189",
-          "name": "Malignant Vipoma",
-          "terminology": "ncit",
-          "version": "25.02d",
-          "conceptStatus": "DEFAULT",
-          "leaf": false,
-          "active": true
-        },
-        {
-          "code": "C19436",
-          "name": "Malignant Conversion",
-          "terminology": "ncit",
-          "version": "25.02d",
-          "conceptStatus": "DEFAULT",
-          "leaf": true,
-          "active": true
-        },
-        {
-          "code": "C36942",
-          "name": "Malignant Oncocyte",
-          "terminology": "ncit",
-          "version": "25.02d",
-          "conceptStatus": "DEFAULT",
-          "leaf": false,
-          "active": true
-        },
-        {
-          "code": "C4456",
-          "name": "Malignant Mesothelioma",
-          "terminology": "ncit",
-          "version": "25.02d",
-          "conceptStatus": "DEFAULT",
-          "leaf": false,
-          "active": true
-        },
-        {
-          "code": "C65191",
-          "name": "Malignant Enteroglucagonoma",
-          "terminology": "ncit",
-          "version": "25.02d",
-          "conceptStatus": "Obsolete_Concept",
-          "leaf": true,
-          "active": true
-        },
-        {
-          "code": "C8991",
-          "name": "Malignant Mastocytosis",
-          "terminology": "ncit",
-          "version": "25.02d",
-          "conceptStatus": "DEFAULT",
-          "leaf": false,
-          "active": true
-        }
-      ]
-    }
-
------------------------------------------------------
-Finished ...Wed, Mar 12, 2025  4:12:22 PM
------------------------------------------------------
-
+-----------------------------------------------------
+Starting ...Mon Aug 25 10:28:58 PDT 2025
+-----------------------------------------------------
+url = https://api-evsrest.nci.nih.gov/api/v1
+terminology = ncit
+term = malignant
+include = 
+
+  Find concepts for ncit malignant:
+
+    {
+      "total": 4778,
+      "timeTaken": 53,
+      "parameters": {
+        "term": "malignant",
+        "type": "contains",
+        "include": "minimal",
+        "fromRecord": 0,
+        "pageSize": 10,
+        "terminology": [
+          "ncit"
+        ]
+      },
+      "concepts": [
+        {
+          "code": "C14143",
+          "name": "Malignant",
+          "terminology": "ncit",
+          "version": "25.07d",
+          "conceptStatus": "DEFAULT",
+          "leaf": true,
+          "active": true
+        },
+        {
+          "code": "C19436",
+          "name": "Malignant Conversion",
+          "terminology": "ncit",
+          "version": "25.07d",
+          "conceptStatus": "DEFAULT",
+          "leaf": true,
+          "active": true
+        },
+        {
+          "code": "C36942",
+          "name": "Malignant Oncocyte",
+          "terminology": "ncit",
+          "version": "25.07d",
+          "conceptStatus": "DEFAULT",
+          "leaf": false,
+          "active": true
+        },
+        {
+          "code": "C4456",
+          "name": "Malignant Mesothelioma",
+          "terminology": "ncit",
+          "version": "25.07d",
+          "conceptStatus": "DEFAULT",
+          "leaf": false,
+          "active": true
+        },
+        {
+          "code": "C65191",
+          "name": "Malignant Enteroglucagonoma",
+          "terminology": "ncit",
+          "version": "25.07d",
+          "conceptStatus": "Obsolete_Concept",
+          "leaf": true,
+          "active": true
+        },
+        {
+          "code": "C8991",
+          "name": "Malignant Mastocytosis",
+          "terminology": "ncit",
+          "version": "25.07d",
+          "conceptStatus": "DEFAULT",
+          "leaf": false,
+          "active": true
+        },
+        {
+          "code": "C65190",
+          "name": "Malignant Somatostatinoma",
+          "terminology": "ncit",
+          "version": "25.07d",
+          "conceptStatus": "DEFAULT",
+          "leaf": false,
+          "active": true
+        },
+        {
+          "code": "C7612",
+          "name": "Malignant Thymoma",
+          "terminology": "ncit",
+          "version": "25.07d",
+          "conceptStatus": "DEFAULT",
+          "leaf": false,
+          "active": true
+        },
+        {
+          "code": "C9305",
+          "name": "Malignant Neoplasm",
+          "terminology": "ncit",
+          "version": "25.07d",
+          "conceptStatus": "DEFAULT",
+          "leaf": false,
+          "active": true
+        },
+        {
+          "code": "C121792",
+          "name": "Malignant PEComa",
+          "terminology": "ncit",
+          "version": "25.07d",
+          "conceptStatus": "DEFAULT",
+          "leaf": false,
+          "active": true
+        }
+      ]
+    }
+
+-----------------------------------------------------
+Finished ...Mon Aug 25 10:28:59 PDT 2025
+-----------------------------------------------------
+

bash-examples/samples/get-association-from-code.txt

@@ -1,21 +1,21 @@
------------------------------------------------------
-Starting ...Wed, Mar 12, 2025  4:12:30 PM
------------------------------------------------------
-url = https://api-evsrest.nci.nih.gov/api/v1
-terminology = ncit
-codeOrLabel = A16
-include = 
-
-  Get association for ncit A16:
-
-    {
-      "code": "A16",
-      "name": "Has_INC_Parent",
-      "terminology": "ncit",
-      "version": "25.02d"
-    }
-
------------------------------------------------------
-Finished ...Wed, Mar 12, 2025  4:12:30 PM
------------------------------------------------------
-
+-----------------------------------------------------
+Starting ...Mon Aug 25 10:29:06 PDT 2025
+-----------------------------------------------------
+url = https://api-evsrest.nci.nih.gov/api/v1
+terminology = ncit
+codeOrLabel = A16
+include = 
+
+  Get association for ncit A16:
+
+    {
+      "code": "A16",
+      "name": "Has_INC_Parent",
+      "terminology": "ncit",
+      "version": "25.07d"
+    }
+
+-----------------------------------------------------
+Finished ...Mon Aug 25 10:29:06 PDT 2025
+-----------------------------------------------------
+

bash-examples/samples/get-association-with-label.txt

@@ -1,35 +1,35 @@
------------------------------------------------------
-Starting ...Wed, Mar 12, 2025  4:12:30 PM
------------------------------------------------------
-url = https://api-evsrest.nci.nih.gov/api/v1
-terminology = ncit
-codeOrLabel = Role_Has_Domain
-include = synonyms
-
-  Get association for ncit Role_Has_Domain:
-
-    {
-      "code": "A1",
-      "name": "Role_Has_Domain",
-      "terminology": "ncit",
-      "version": "25.02d",
-      "synonyms": [
-        {
-          "name": "Role Has Domain",
-          "type": "Display_Name"
-        },
-        {
-          "name": "Role_Has_Domain",
-          "type": "FULL_SYN"
-        },
-        {
-          "name": "Role_Has_Domain",
-          "type": "Preferred_Name"
-        }
-      ]
-    }
-
------------------------------------------------------
-Finished ...Wed, Mar 12, 2025  4:12:31 PM
------------------------------------------------------
-
+-----------------------------------------------------
+Starting ...Mon Aug 25 10:29:07 PDT 2025
+-----------------------------------------------------
+url = https://api-evsrest.nci.nih.gov/api/v1
+terminology = ncit
+codeOrLabel = Role_Has_Domain
+include = synonyms
+
+  Get association for ncit Role_Has_Domain:
+
+    {
+      "code": "A1",
+      "name": "Role_Has_Domain",
+      "terminology": "ncit",
+      "version": "25.07d",
+      "synonyms": [
+        {
+          "name": "Role Has Domain",
+          "type": "Display_Name"
+        },
+        {
+          "name": "Role_Has_Domain",
+          "type": "FULL_SYN"
+        },
+        {
+          "name": "Role_Has_Domain",
+          "type": "Preferred_Name"
+        }
+      ]
+    }
+
+-----------------------------------------------------
+Finished ...Mon Aug 25 10:29:07 PDT 2025
+-----------------------------------------------------
+