Expose a Register function that can be used to install routes in subrouter

[maddy-jo]

Expose a Register function that can be used to install routes in subrouter

Takes the existing logic for generating the routes in gen-go/server and applies them to an injected router. This allows a server to compose routers by calling

Register(parentRouter.PathPrefix("/subrouter-prefix").Subrouter(), controller)

Testing this hypothesis out in app-district-service.

Jira

SHAPI-1697

Testing

See Clever/app-district-service#2.

$ curl -X GET http://localhost:8080/v2/things -i          
HTTP/1.1 500 Internal Server Error
Content-Type: text/plain; charset=utf-8
Vary: Accept-Encoding
X-Content-Type-Options: nosniff
Date: Tue, 17 Jun 2025 00:22:25 GMT
Content-Length: 44

{"message":"TODO, this is just an example"}
madeline.lumetta> app-district-service $ curl -X GET http://localhost:8080/districts/v2/things -i
HTTP/1.1 500 Internal Server Error
Content-Type: text/plain; charset=utf-8
Vary: Accept-Encoding
X-Content-Type-Options: nosniff
Date: Tue, 17 Jun 2025 00:22:30 GMT
Content-Length: 44

{"message":"TODO, this is just an example"}
madeline.lumetta> app-district-service $ curl -X GET http://localhost:8080/sessions/v2/things -i 
HTTP/1.1 500 Internal Server Error
Content-Type: text/plain; charset=utf-8
Vary: Accept-Encoding
X-Content-Type-Options: nosniff
Date: Tue, 17 Jun 2025 00:22:38 GMT
Content-Length: 44

{"message":"TODO, this is just an example"}

madeline.lumetta> app-district-service $ curl -X GET http://localhost:8080/wrong/v2/things -i   
HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=utf-8
Vary: Accept-Encoding
X-Content-Type-Options: nosniff
Date: Tue, 17 Jun 2025 00:22:41 GMT
Content-Length: 19

404 page not found

Checklist

• Run make build
• Run make generate
• Update the current version in the /VERSION file. First line should be JUST the version e.g. v10.13.1. Then a blank line. Then release notes.

[andruwm]

I am untagging myself here so I don't get prompted by slack everyday to review, but feel free to re-tag me at any point if you are ready for a review.

[andruwm]

The code changes here look reasonable. It's be helpful to add another swagger file which uses this new feature in samples so that its easier to understand how both the client and server look on a simple app.

[andruwm]

We should have had one of these a long time ago.

[maddy-jo]

yeah I think this would be worth cherry-picking into its own PR, probably?

[andruwm]

Agreed

[andruwm]

The code changes here look reasonable. It's be helpful to add another swagger file which uses this new feature in samples so that its easier to understand how both the client and server look on a simple app.

I just looked through the sample PR provided and was able to get a good idea of it there, but having it all in one place would be awesome at some point. Doesnt need to be now.