Merge pull request #608 from sklump/order-openapi-call-parms

order swagger path parameters by location, required/optional, lexicog…

aries_cloudagent/admin/server.py

@@ -271,7 +271,15 @@ async def start(self) -> None:
         if plugin_registry:
             plugin_registry.post_process_routes(self.app)
 
-        self.app._state["swagger_dict"].get("tags", []).sort(key=lambda t: t["name"])
+        # order tags alphabetically, parameters deterministically and pythonically
+        swagger_dict = self.app._state["swagger_dict"]
+        swagger_dict.get("tags", []).sort(key=lambda t: t["name"])
+        for path in swagger_dict["paths"].values():
+            for method_spec in path.values():
+                method_spec["parameters"].sort(
+                    key=lambda p: (p["in"], not p["required"], p["name"])
+                )
+
         self.site = web.TCPSite(runner, host=self.host, port=self.port)
 
         try: