feat: select columns

[ymarcon]

Columns to select can be specified by providing a list of field names.

Other updates:

• sort direction is case insensitive
• added documentation about filter, sort and range query parameters

[guilbep]

Ça ressemble vraiment a du JSON. Pourquoi on utilise pas un parser json ? ou alors j'ai loupé qqch ?

[ymarcon]

Ça ressemble vraiment a du JSON. Pourquoi on utilise pas un parser json ? ou alors j'ai loupé qqch ?

Oui ce serait bien d'avoir une forme de validation. Note qu'il y a un peu de flexibilité pour pouvoir gérer les jointures. Ce n'est pas encore documenté mais c'est possible de spécifier des critères sur les tables jointes, genre "donne moi les études dont les buildings sont ceci celà". Présentement ça marche mais l'api aurait besoin d'être améliorée je pense.

[guilbep]

@ymarcon the lllm generated this jsonSchema :)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "ENAC-IT4R Python SQL Utils",
  "type": "object",
  "properties": {
    "filter": {
      "type": "object",
      "additionalProperties": {
        "type": "object",
        "properties": {
          "$and": {
            "type": "array",
            "items": { "$ref": "#" }
          },
          "$or": {
            "type": "array",
            "items": { "$ref": "#" }
          },
          "$eq": { "type": "string" },
          "$ne": { "type": "string" },
          "$lt": { "type": "number" },
          "$lte": { "type": "number" },
          "$le": { "type": "number" },
          "$gt": { "type": "number" },
          "$gte": { "type": "number" },
          "$ge": { "type": "number" },
          "$ilike": { "type": "string" },
          "$like": { "type": "string" },
          "$contains": {
            "type": "array",
            "items": { "type": "string" }
          },
          "$in": {
            "type": "array",
            "items": { "type": "string" }
          },
          "$nin": {
            "type": "array",
            "items": { "type": "string" }
          },
          "$exists": { "type": "boolean" }
        },
        "additionalProperties": false
      }
    },
    "sort": {
      "type": "array",
      "items": [
        { "type": "string" },
        { "type": "string", "enum": ["ASC", "DESC"], "default": "ASC" }
      ],
      "minItems": 1,
      "maxItems": 2
    },
    "range": {
      "type": "array",
      "items": { "type": "integer" },
      "minItems": 2,
      "maxItems": 2
    }
  },
  "required": ["filter", "sort", "range"],
  "additionalProperties": false
}

[ymarcon]

Mis à part qu'il faudrait un "additionalProperties": true sur filter, c'est pas mal bon!

[ymarcon]

See issue #3