4 ms·

Author here. I covered almost everything in the documentation. And there is also a small example which is hosted at https://github.com/alpaca-api https://github

Author here. I covered almost everything in the documentation. And there is also a small example which is hosted at https://github.com/alpaca-api https://github.com/alpaca-api. Please ask if you have any questions. Thanks

htuao 13y ago
How do you differ from Swagger, Blueprint, I/O Docs, RAML and all these API endpoint descriptions?
- sunkarapk 13y ago
  I tried searching for a program which generates client libraries in different programming languages and failed. Could you please link if something does it? From what I gather, the above mentioned sites only provide methods of describing the API and/or Automating the API on the server side. Nothing is said about client libraries. Thanks
  - mattdawson 13y ago
    http://thrift.apache.org/ http://thrift.apache.org/
    - jerf 13y ago
      I think that creates an API, then exposes it in numerous languages. This writes wrappers to existing APIs. Not the same thing. (Lots of code similarity under the hood, though.)
      - mattdawson 13y ago
        No, it actually does both - which is why I was so interested in it initially. from the above link: "generates code to be used to easily build RPC clients and servers" TBF, I haven't used it as a developer, but I did contract work with a company that had invested in it heavily. From what I saw of their workflow, it ended up being a pretty nice bootstrap tool and little more. edit: Oh, I see what you're saying. Yes, you're correct - thrift does not wrap existing APIs.
  - michaelmior 13y ago
    Why create a new format for describing APIs instead of using something like RAML? The client library generation is very useful, but it would be nice if there wasn't yet another format needed to describe the API.
  - matt_kantor 13y ago
    https://github.com/wordnik/swagger-codegen https://github.com/wordnik/swagger-codegen
  - fzltrp 13y ago
    There's this utility called swig(http://www.swig.org/ http://www.swig.org/) which let you create wrappers for C/C++ libraries to a number of different target languages (dynamic and static), though often time languages offer ffi on their own. The code generated by this tool is rather heavy weight though. Also I'm not quite sure if this is what you're looking for.
  - fehguy 13y ago
    https://github.com/wordnik/swagger-codegen https://github.com/wordnik/swagger-codegen does javascript, scala, java, objective-c, php, python (3), ruby, android, and even flash Also has the benefit of a commercial backer (https://helloreverb.com https://helloreverb.com) and a real app depending on it
rybosome 13y ago
Hey, I noticed you mentioned that you were interested in having client library generation in Obj-C, Java, and Scala, yet all of the existing client lib support is for dynamic languages. I think you may find that some fundamental changes need to be made to support this, unless every datatype is just going to be a string.
- sunkarapk 13y ago
  If you are talking about API definition, there need not be many changes since api.json do not define any objects. If you are talking about the code of the program, they wont be changed because, the program just compiles and executes the templates. If I didnt answer your question properly, could you please elaborate?

htuao 13y ago

How do you differ from Swagger, Blueprint, I/O Docs, RAML and all these API endpoint descriptions?

sunkarapk 13y ago
I tried searching for a program which generates client libraries in different programming languages and failed. Could you please link if something does it? From what I gather, the above mentioned sites only provide methods of describing the API and/or Automating the API on the server side. Nothing is said about client libraries. Thanks
- mattdawson 13y ago
  http://thrift.apache.org/ http://thrift.apache.org/
  - jerf 13y ago
    I think that creates an API, then exposes it in numerous languages. This writes wrappers to existing APIs. Not the same thing. (Lots of code similarity under the hood, though.)
    - mattdawson 13y ago
      No, it actually does both - which is why I was so interested in it initially. from the above link: "generates code to be used to easily build RPC clients and servers" TBF, I haven't used it as a developer, but I did contract work with a company that had invested in it heavily. From what I saw of their workflow, it ended up being a pretty nice bootstrap tool and little more. edit: Oh, I see what you're saying. Yes, you're correct - thrift does not wrap existing APIs.
- michaelmior 13y ago
  Why create a new format for describing APIs instead of using something like RAML? The client library generation is very useful, but it would be nice if there wasn't yet another format needed to describe the API.
- matt_kantor 13y ago
  https://github.com/wordnik/swagger-codegen https://github.com/wordnik/swagger-codegen
- fzltrp 13y ago
  There's this utility called swig(http://www.swig.org/ http://www.swig.org/) which let you create wrappers for C/C++ libraries to a number of different target languages (dynamic and static), though often time languages offer ffi on their own. The code generated by this tool is rather heavy weight though. Also I'm not quite sure if this is what you're looking for.
- fehguy 13y ago
  https://github.com/wordnik/swagger-codegen https://github.com/wordnik/swagger-codegen does javascript, scala, java, objective-c, php, python (3), ruby, android, and even flash Also has the benefit of a commercial backer (https://helloreverb.com https://helloreverb.com) and a real app depending on it

rybosome 13y ago

Hey, I noticed you mentioned that you were interested in having client library generation in Obj-C, Java, and Scala, yet all of the existing client lib support is for dynamic languages. I think you may find that some fundamental changes need to be made to support this, unless every datatype is just going to be a string.

sunkarapk 13y ago
If you are talking about API definition, there need not be many changes since api.json do not define any objects. If you are talking about the code of the program, they wont be changed because, the program just compiles and executes the templates. If I didnt answer your question properly, could you please elaborate?