cebe / cebe/php-openapi

Support OpenAPI 3.1

Ouverte
#101 2 commentaires 15 réactions 0 personnes assignées Voir sur GitHub
openapi 3.1
Langage dominant
PHP
Étoiles
500
Forks
99
Métriques de merge des PR
Aucune PR mergée en 30 j

Description

OpenAPI 3.1 has just been released... Can we hope for support in this library?

Changes in the spec seems really small, but there are some small BCs that could complicate the stuff further: https://www.openapis.org/blog/2021/02/16/migrating-from-openapi-3-0-to-3-1-0

Main differences:
* no more `nullable`
```diff
-type: string
-nullable: true
+type:
+ - "string"
+ - "null"
```
* `exclusiveMinimum` and `exclusiveMaximum` are used directly
```diff
-minimum: 7
-exclusiveMinimum: true
+exclusiveMinimum: 7
```
* `examples`, no more `example`
```diff
-example: fedora
+examples:
+ - fedora
```
* Describing File Upload Payloads
* declaring JSON Schema dialect explicitly

Guide de contribution

Aucun guide de contribution indexé pour ce dépôt

Piste de recherche

Commencez par examiner les notes de migration d’OpenAPI 3.0 vers 3.1 liées dans l’issue et comparez-les avec la gestion actuelle d’OpenAPI par cette bibliothèque. Le travail sera considéré comme terminé lorsque la bibliothèque prendra en charge les changements 3.1 indiqués, notamment les types nullable, les bornes exclusives directes, les exemples, les charges utiles de téléversement de fichiers et les dialectes JSON Schema explicites.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Évaluation

Stack technique
openapi, php
Domaine
api
Type d'issue
Fonctionnalité
Difficulté
5/5
Temps estimé
Plus d'une semaine
Activité
À l'abandon
Clarté
Plutôt claire
Accessibilité débutants
35/100

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.