mindev: Add utility to generate a data source definition from a Swagger doc

[JAORMX]

Summary

This adds the following command: mindev datasource generate ...

The aforementioned command will read a swagger doc (OpenAPI v2) and will
generate the appropriate data source definition out of it.

I went for v2 since there was an easy-to-use implementation ready.
Adding v3 support is left as a TODO item.

Here's a demo of how usage would look like:

$ cat sample.yaml
swagger: "2.0"

info:
  title: Sample API
  description: Optional multiline or single-line description in [CommonMark](http://commonmark.org/help/) or HTML.
  version: 0.1.9

basePath: http://api.example.com/v1

paths:
  /users:
    get:
      summary: Returns a list of users.
      description: Optional extended description in CommonMark or HTML.
      responses:
        "200": # status code
          description: A JSON array of user names
          content:
            application/json:
              schema:
                type: array
                items:
                  type: string

$ go run cmd/dev/main.go datasource generate sample.yaml
version: v1
type: data-source
context: {}
name: Sample-API
rest:
  def:
    get_users:
      endpoint: http://api.example.com/v1/users
      method: GET
      parse: json
      inputSchema: {}

Change Type

Mark the type of change your PR introduces:

• Bug fix (resolves an issue without affecting existing features)
• Feature (adds new functionality without breaking changes)
• Breaking change (may impact existing functionalities or require documentation updates)
• Documentation (updates or additions to documentation)
• Refactoring or test improvements (no bug fixes or new functionality)

Testing

Outline how the changes were tested, including steps to reproduce and any relevant configurations.
Attach screenshots if helpful.

Review Checklist:

• Reviewed my own code for quality and clarity.
• Added comments to complex or tricky code sections.
• Updated any affected documentation.
• Included tests that validate the fix or feature.
• Checked that related changes are merged.

[coveralls]

coverage: 56.609% (+0.003%) from 56.606%
when pulling 8d83735 on JAORMX:generate-ds
into 2caea05 on mindersec:main.

[rdimitrov]

Can we add 1 or more tests so we can ensure we don't accidentally break the generation part. Otherwise it looks good 👍

[JAORMX]

Can we add 1 or more tests so we can ensure we don't accidentally break the generation part. Otherwise it looks good 👍

will do... on Wednesday 😄

[rdimitrov]

Can we add 1 or more tests so we can ensure we don't accidentally break the generation part. Otherwise it looks good 👍

will do... on Wednesday 😄

Oh, in that case I don't mind merging this one and doing it as a follow up 👍