There is an example of how to use a spec-generated Ruby client

[sgnn7]

We need to have some sort of documentation about how to use the generated clients in a few languages. Something like TIOBE index would be a good start to see which ones. Most likely the relevant ones for us would be: Golang, Ruby, Python, Java, JS, and .NET

A resolution for this issue would include

• An example use of the OpenAPI spec generated Ruby client, covering:
  • Authentication
  • Changing password
  • Rotating API key
  • Loading policy
  • Store/retrieve secrets
  • Basic authentication
  • Conjur Token authentication
• Accompanying documentation

[izgeri]

@john-odonnell can you fill this in to be a bit more clear about the scope of the card you are working on? the card definition should make it clear how you know when you are "done" - right now, I'm not sure what exactly the outcome of this card will be.

I would suggest scoping it to something that's pretty limited - for example, limit it to Python in this one card and we can add separate cards for other language clients & examples

Also, what does this mean by "example usage"?

[john-odonnell]

@izgeri I'm reading "example usage" as a workflow that shows exactly how a user would interface with Conjur in a certain language using a generated client. When a client is generated for a language, it includes some documentation on getting started, but it can be pretty barebones, and the quality varies language-to-language. I've been using these examples to exhibit using popular Conjur endpoints so users will have a good idea how to get started with some basics.

There is already a Python example in main, so I think I'll make this one Ruby specific.