News for hackers. Stuff that matters.
Re:Django REST framework 3.6 released by minimaxir on Thursday March 09, 2017 @12:39PM (#13831024)
What does "new JavaScript client library" mean in the context of front-end libraries like React?

A DRF API + React stack seems like a good combo so I've been looking into that workflow.

Re:Django REST framework 3.6 released by theptip on Thursday March 09, 2017 @12:54PM (#13831198)
The "client library" being referred to is an autogenerated API client, like https://github.com/swagger-api/swagger-js.

Recent DRF releases have been building the CoreAPI schema definition format, which is a generic schema language like OpenAPI (nee Swagger) or API Blueprint.

The other headline DRF feature (API docs) also builds on the CoreAPI schema.

If you prefer existing standards, you can map your DRF API to Swagger using https://github.com/marcgibbons/django-rest-swagger/, and then use swagger-js (or swagger-codegen) to generate client implementations -- though the django-rest-swagger project is currently partially broken due to having migrated to CoreAPI before the latter obtained feature-parity with Swagger; the 0.3 version is more full-featured.

Re:Django REST framework 3.6 released by wing328hk on Friday March 10, 2017 @09:39AM (#13838872)
Just want to add that swagger-js is a "dynamic" API client, which means it will load the OpenAPI/Swagger spec [1] during runtime.

If you prefer static API clients/SDKs, please try Swagger Codegen [2] (free, open-source) instead, which supports 30+ API clients and 20+ server stubs as well as API documentations.

[1] https://github.com/OAI/OpenAPI-Specification [2] https://github.com/swagger-api/swagger-codegen

Disclosure: I'm a top contributor to Swagger Codegen.

Re:Django REST framework 3.6 released by tomchristie on Friday March 10, 2017 @08:26AM (#13838367)
To be precise I'd call it a "dynamic API client". The codebase doesn't change, you read the schema and corresponding actions become available on the client.

There are also "autogenerated API clients", where the API code is templated, based on the API schema.

(I think the swagger-js client also falls into the "dynamic" category, tho most other language implementations based on swagger fall into the templated "autogenerated" category.)

And, yup, working towards bring Core API up to feature parity with Swagger, so that you can fully interoperate with everything that the Swagger ecosystem already provides.

Re:Django REST framework 3.6 released by mplewis on Thursday March 09, 2017 @12:57PM (#13831222)
They describe what it means later in the page [1]:

> The JavaScript client library allows you to load an API schema, and then interact with that API at an application layer interface, rather than constructing fetch requests explicitly.

It looks like it generates a JS library that makes it easy to use the same resource names in your JS as Django without having to write route handlers by hand. In their example, it looks like they list projects by calling

    client.action(schema, ['projects', 'list']).then(...)
[1]: http://www.django-rest-framework.org/topics/3.6-announcement...
Re:Django REST framework 3.6 released by jarcoal on Thursday March 09, 2017 @12:54PM (#13831191)
I haven't looked too deeply, but it appears to be an API interaction layer. So if React is your V in MVC, this is the M.