microsoftgraph / microsoftgraph/msgraph-sdk-python
Document backing store
Personne n'a encore pris cette issue.
- Langage dominant
- Python
- Étoiles
- 630
- Forks
- 96
- Merge moyen
- 15 h 20 min
- PR mergées (30 j)
- 3
Description
Is your feature request related to a problem? Please describe.
When I first used this SDK, I modified objects that were returned but just for the needs of my script, with no intention of pushing back to the API the modifications. It didn't work properly and I had a couple of issues that I didn't understand at first, until I noticed that this SDK uses a notion of "backing store". I didn't dig deeper what it was but now I understand thanks to this description in the Java Graph SDK for the "backing store" and "dirty" mechanisms which I believe are the same as in this Python SDK.
Describe the solution you'd like
If it's indeed the same thing, please raise awareness about it in the README (or elsewhere) to reduce confusion
Describe alternatives you've considered
Perhaps I could have spent more time and managed to find the article myself, or this https://learn.microsoft.com/en-us/openapi/kiota/models#backing-store
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Examinez le README et les descriptions liées du backing store de Microsoft Graph Java et de Kiota. Confirmez le fonctionnement du backing store et des dirty mechanisms du Python SDK, puis documentez-les dans le README ou à un autre emplacement approprié afin que les utilisateurs comprennent quand les modifications apportées aux objets renvoyés sont suivies ou renvoyées à l’API.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- python
- Domaine
- documentation
- Type d'issue
- Documentation
- Difficulté
- 2/5
- Temps estimé
- 1-3 heures
- Activité
- À l'abandon
- Clarté
- Plutôt claire
- Accessibilité débutants
- 35/100