Return generated model instances from connector operations
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 32/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Attiva
- Stack tecnologico
- python
- Ambito
- api, backend-api-design, tooling
Direzione di ricerca
Start with the CodefulSdkGenerator and the generated connector operation methods, then inspect the pinned managed connector contracts and existing serialization/deserialization tests. Add coverage for modeled, nested, collection, optional, wire-name, binary, text, and empty responses, regenerate affected clients, and verify the artifacts match the paired generator revision and updated API documentation.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Problem
Generated connector clients expose response model classes, but operation methods currently deserialize JSON responses to weak dictionary types. For example, Office365Client.get_emails_async returns dict[str, Any] | None rather than an instance of its generated response model. This prevents callers and documentation from relying on typed response properties.
Identified in PR #89 review.
Proposed work
- Update the CodefulSdkGenerator to emit precise operation return annotations when the managed connector contract defines a response schema.
- Deserialize JSON responses into the corresponding generated model classes, including nested models, collections, optional fields, and wire-name mappings.
- Preserve dictionary, binary, text, and empty-response behavior when no generated response model applies.
- Regenerate affected connector clients from pinned contracts and link the paired AzureUX-BPM generator PR.
- Update API documentation after typed responses are available.
Acceptance criteria
- Connector operations with modeled response schemas return generated model instances rather than
dict[str, Any]. - Return annotations distinguish modeled, unmodeled, binary, text, and no-content responses.
- Serialization/deserialization tests cover nested objects, collections, optional fields, and wire-name mappings.
- Existing connector behavior remains compatible for responses without modeled schemas.
- Generated artifacts match the paired generator revision.
- Lingua principale
- Python
- Stelle
- 0
- Fork
- 3
- Merge medio
- 4g 16h
- PR unite (30g)
- 12
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di Azure/connectors-python-sdk
-
Difficoltà 5/5 Più di una settimana Idoneità per principianti 30/100
Azure/connectors-python-sdk#91 ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di Azure/connectors-python-sdk
Issue simili
-
enhancement
Difficoltà 2/5 1-3 ore Idoneità per principianti 85/100
epam/ai-dial-quickapps-backend#628 ·
I maintainer di solito rispondono entro 2 giorni
-
0xlau.dev 已失效，切换成 timlau.meAperta
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 69/100
timqian/chinese-independent-blogs#2235 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
eclipse-score/coverage_tool#27 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 65/100
bojieli/ai-agent-book#1174 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
RedHatQE/mtv-api-tests#721 ·
I maintainer di solito rispondono entro 1 giorno