Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

Return generated model instances from connector operations

Geschlossen
#90 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Anfängerfreundlichkeit
35/100
Issue-Typ
Feature
Klarheit
Größtenteils klar
Aktivitätsstatus
Aktiv
Tech-Stack
python
Bereich
api, tooling

Rechercherichtung

Start with the CodefulSdkGenerator and the generated connector operation methods, using the PR #89 review and pinned contracts as context. Trace how modeled and unmodeled responses are currently represented, then review the serialization/deserialization test coverage requested for nested models, collections, optional fields, and wire-name mappings. Done means generated artifacts, annotations, behavior, tests, and API documentation match the paired generator revision.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

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.
Vorherrschende Sprache
Python
Sterne
0
Forks
3
Ø Merge
3 T. 11 Std.
Gemergte PRs (30 T.)
10

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus Azure/connectors-python-sdk

Alle Issues in Azure/connectors-python-sdk

Ähnliche Issues

Weitere Issues zu Python

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.