Typings do not match current interface

[RobertDiebels]

The Typecript index.d.ts does not reflect the 5.2.0 interface.
KubernetesClient.Client is missing.

[silasbw]

Yeah, we need to add this and it's high on the priority list. If someone wants to help out, the high-level approach would be:

1. Add client classes for the existing swaggers specs in lib/specs. E.g., add a Client class to lib/client-1.7:

const SwaggerClient = require('./swagger-client');
module.export = class Client extends SwaggerClient {
  constructor() {
    super({ version: '1.7' });
  }
};

2. Add a typings.js script similar to the docs one that generates typings for a specified swagger spec and the associated static clients defined in 1.
3. Generate typings for the included swagger specs in lib/specs and commit them.

[jeffmaury]

I am trying to use the bindings from a VSCode extension for OpenShift but did not manage to find the solution. Is this related to this one as well ?

[silasbw]

Yep -- do you have some time to help out :)?

[jeffmaury]

Yes no pb

[shcallaway]

Still an issue in 5.3.1.

[silasbw]

I know, I'm sorry :(

I have a half-baked branch that generates the bindings. It's not quite ready, and I keep telling myself "I'll do it this weekend". I'll see what I can do. I'll at least try to dust it off and push it up in case someone else wants to contribute to it or take it over.

[RobertDiebels]

@silasbw I believe I read something about a typescript generator for the OpenAPISpec a while ago maybe that would be a direction investigate? Could possibly save you some time.

EDIT: I don't have the time to look at this issue further unfortunately.

[silasbw]

It would, but it doesn't generate very "fluent" names for the API calls. The names basically end up being the Operation ID which are pretty unwieldy and don't map well to the kubernetes reference documentation. I discuss this more is https://godaddy.github.io/2018/04/10/an-intuitive-nodejs-client-for-the-kubernetes-api/.

Qualitatively I like the API naming conventions that kubernetes-client uses (e.g., client.api.namespaces('foo').pods('goo').get(), but it comes at the cost of writing our own generators.