port to graphql!?!

[hannesm]

http://githubengineering.com/the-github-graphql-api/ -- fewer data transferred than using the REST API

[dsheets]

And finally real, GitHub-provided types! I'm investigating this now (but it will likely be some time before it leaves Early Access). In the mean time, we'll have 1.2 and maybe 1.3 but we should start building the infrastructure for 2.0.

[avsm]

GraphQL has a type system that forces the server to be unambiguous about requests it receives and responses it produces.

I'm crying tears of typing joy

[yallop]

The GraphQL API is out of Early Access: https://github.com/blog/2359-introducing-github-marketplace-and-more-tools-to-customize-your-workflow

[avsm]

GraphQL server in OCaml: https://discuss.ocaml.org/t/ann-graphql-0-1-0/282

[andreas]

I have something working now, which may be of interest: andreas/ocaml-graphql-server#56

I would be happy to hear if you have any thoughts on how graphql-ppx could work with ocaml-github, or if you have any particular requirements.

[andreas]

Here's a simple example of how it could work with Lwt, Cohttp and Github GraphQL API: github.ml.

If you check out the branch locally, you can build with jbuilder build graphql-ppx/examples/github.exe and run with GITHUB_TOKEN=xyz ./_build/default/graphql-ppx/examples/github.exe.

[shinzui]

@andreas did you delete the github example?

[andreas]

It's available here: https://github.com/andreas/ppx_graphql/blob/master/examples/github.ml

[XVilka]

A lot has changed since and the v3 API is getting slowly deprecated, the transition is imminent, see more at:

• https://developer.github.com/v4/
• https://graphql.org/
• https://developer.github.com/marketplace/getting-started/
• https://developer.github.com/v4/guides/migrating-from-rest/

It will require GraphQL library by @andreas. See its repository at andreas/ocaml-graphql-server.

[andreas]

It will require GraphQL library by @andreas. See its repository at andreas/ocaml-graphql-server.

Actually the GraphQL PPX I mentioned above is no longer available in ocaml-graphql-server -- the library is now solely for writing GraphQL servers, not clients 🙂

The most mature GraphQL PPX library is currently reasonml-community/graphql_ppx, though it's not getting a lot of love in terms of OCaml/OPAM.

[Zimmi48]

@XVilka Contrary to what you are claiming the GitHub REST API (v3) is not at all getting deprecated. In issue ocaml-opam/opam-publish#97, the title is misleading, it's just the authentication method that is getting deprecated.

There isn't much point in porting the ocaml-github library to GraphQL IMHO because this library provides OCaml bindings to the REST API resources but, when you use GraphQL, the needs of each user are quite different and therefore, they directly need to write their GraphQL queries (no point in providing bindings).

The graphql_ppx library mentioned by @andreas above is indeed awesome (since it types your requests) and it is the only thing you need if you want to build an OCaml project depending on GraphQL. Its latest version is available in opam now (thanks to my intern who opened ocaml/opam-repository#16540) and it's actively used in the coqbot project (https://github.com/coq/bot/, cf. the bot-components folder).

[roddyyaga]

The fix for that opam-publish issue was made in this PR, available in 4.3.0.

[XVilka]

@roddyyaga it broke the authorization though, see:

• opam publish fails with 401 Unauthorized ocaml-opam/opam-publish#99 (comment)
• opam publish fails with HTTP Error 404 Not Found ocaml-opam/opam-publish#104

Thus, current recommendation is to use 4.2.0 instead.