Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Use names of children as a source for current object naming

Abierto
#856 2 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
35/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Estancado
Stack tecnológico
rust

Línea de trabajo

Comienza con la ruta de generación de enums de oneOf que actualmente emite Variant0 y Variant1; compárala con el caso que solo usa oneOf descrito en el issue. Usa los ejemplos de OpenAPI proporcionados, especialmente StateChangeCauseView, para comprobar que los títulos de los elementos hijos producen Result y Error, mientras que los elementos hijos sin nombre conservan un nombre alternativo. La tarea estará terminada cuando las variantes de Rust generadas sean más legibles sin romper la nomenclatura existente.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

typify2

Hi! So, I have this spec:

Spec with oneOf and additional properties
{
    "openapi": "3.0.0",
    "info": {
        "title": "My API",
        "version": "1.0.0"
    },
    "paths": {
        "/my_request": {
            "post": {
                "operationId": "my_request",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/JsonRpcResponse_for_Result_and_Error"
                            }
                        }
                    },
                    "required": true
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "JsonRpcResponse_for_Result_and_Error": {
                "oneOf": [
                    {
                        "properties": {
                            "result": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "result"
                        ],
                        "type": "object",
                        "title": "Result"
                    },
                    {
                        "properties": {
                            "error": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "error"
                        ],
                        "type": "object",
                        "title": "Error"
                    }
                ],
                "properties": {
                    "id": {
                        "type": "string"
                    }
                },
                "required": [
                    "id"
                ],
                "title": "JsonRpcResponse_for_Result_and_Error",
                "type": "object"
            }
        }
    }
}

And it produces the following code:

#[derive(:: serde :: Deserialize, :: serde :: Serialize, Clone, Debug)]
    #[serde(untagged)]
    pub enum JsonRpcResponseForResultAndError {
        Variant0 {
            id: ::std::string::String,
            result: ::std::string::String,
        },
        Variant1 {
            error: ::std::string::String,
            id: ::std::string::String,
        },
    }
      

It's not a big deal, nor it is a bug. But a suggestion for improvement. The struct generates Variant0 and Variant1 enum options. In this case, what can be generated instead is Result and Error enum options:

#[derive(:: serde :: Deserialize, :: serde :: Serialize, Clone, Debug)]
    #[serde(untagged)]
    pub enum JsonRpcResponseForResultAndError {
        Result {
            id: ::std::string::String,
            result: ::std::string::String,
        },
        Error {
            error: ::std::string::String,
            id: ::std::string::String,
        },
    }

Like it does for the following schema:

Spec with oneOf only
{
    "openapi": "3.0.0",
    "info": {
        "title": "My API",
        "version": "1.0.0"
    },
    "paths": {
        "/my_request": {
            "post": {
                "operationId": "my_request",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/JsonRpcResponse_for_Result_and_Error"
                            }
                        }
                    },
                    "required": true
                },
                "responses": {
                    "200": {
                        "description": "",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "string"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "JsonRpcResponse_for_Result_and_Error": {
                "oneOf": [
                    {
                        "properties": {
                            "result": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "result",
                            "id"
                        ],
                        "type": "object",
                        "title": "Result"
                    },
                    {
                        "properties": {
                            "error": {
                                "type": "string"
                            },
                            "id": {
                                "type": "string"
                            }
                        },
                        "required": [
                            "error",
                            "id"
                        ],
                        "type": "object",
                        "title": "Error"
                    }
                ],
                "title": "JsonRpcResponse_for_Result_and_Error",
                "type": "object"
            }
        }
    }
}

So I guess the change may be to use titles of object's children as a source for naming current enum Option.

I would provide a real example we are dealing with at https://github.com/near/nearcore/, which is a spec for StateChangeCauseView.
The result is kinda messy - you can see Variant10. The original type is actually a struct with enum flattened into it

I believe fixing this would provide a more human readable code and would be better for developer experience for most cases.

Lenguaje dominante
Rust
Estrellas
898
Forks
114
Merge medio
4 h 18 min
PR fusionados (30 d)
14

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de oxidecomputer/typify

Todos los issues de oxidecomputer/typify

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.