Perfect, that's what I was hoping. How are the Discovery docs created? I suspect that there is a program that takes the annotated code (python / java) and creates the document? Where would one find this tool? I apologize if it is in the SDK. I couldn't find it.
- Kyle On Jul 10, 2012, at 8:10 PM, Dan Holevoet wrote: > Hi Kyle, > > Discovery documents are served for all Endpoints (at > your_app_id.appspot.com/_ah/apis/discovery/v1/apis) just like Google-authored > APIs. We also provide a local version of the discovery doc (as a file) when > you do local development so you don't have to push to production to test your > Endpoint. > > The local discovery doc is used to generate the Objective-C library. The Go > generator would use the local file as well. (Of course, you can point them to > the live discovery doc if you'd like to.) So, I think we're offering what you > want. Apologies if my explanation is (or was) confusing. I'm happy to > elaborate further. > > Thanks, > Dan > > > On Tue, Jul 10, 2012 at 4:11 PM, Kyle Finley <[email protected]> wrote: > Hi Dan, > > Thank you for your reply. > > If you're just interested in generating a client library for an Endpoint that > you can consume in Go, you can probably use the gen.go file provided by the > Go client library. I must include the disclaimer that this is entirely > untested, the generated library may make assumptions which are incorrect for > non-Google-authored APIs. > > Yeah this is partly was I was interested in. I must admin I'm not completely > clear on how "endpoints" works. I thought that you might have a tools that > created discovery docs from annotated code. That's was what I was interested > in looking at. I'm sure I can create something similar. I just thought > looking at some code might help. > > I think this whole process has a lot potential as an open source standard. > Everyone is struggling for consistency In there API's. You guys have done a > lot good work with the discovery api and the tools that parse I would like to > see that spread. > > Thank you, > > Kyle > > If you want to write a backend in Go, there are probably some server-side > details that would block your implementation. > > Thanks, > Dan > > -- > You received this message because you are subscribed to the Google Groups > "Google App Engine" group. > To view this discussion on the web visit > https://groups.google.com/d/msg/google-appengine/-/ArnV9WAiW0MJ. > > To post to this group, send email to [email protected]. > To unsubscribe from this group, send email to > [email protected]. > For more options, visit this group at > http://groups.google.com/group/google-appengine?hl=en. > > > > -- > Dan Holevoet > Google Developer Relations > > > -- > You received this message because you are subscribed to the Google Groups > "Google App Engine" group. > To post to this group, send email to [email protected]. > To unsubscribe from this group, send email to > [email protected]. > For more options, visit this group at > http://groups.google.com/group/google-appengine?hl=en. -- You received this message because you are subscribed to the Google Groups "Google App Engine" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/google-appengine?hl=en.
