Comments (3)
@JonathanGiles - please add guidelines on recommendations on how to implement mockable clients. The current guidance is a copy of the general guidelines and not sufficient.
from sdk.
Notes from Architecture Board:
Recording: https://msit.microsoftstream.com/video/dab58b12-8ebe-49ed-8ace-876af461db84
PR #894 (Draft)
- 3 discussion points
- Jeffrey notes about recordings and how they work. There are many things we have to ignore - it generally works, but someone has to identify whether a field is valid or needs to be ignored.
- How to deal with situations where the service team breaks the endpoint APIs after tests are recorded. Isn't that a breaking change, or point to a breaking change? The guideline should almost be the reverse (after GA) since our intent is to avoid breaking changes - there are situations where the recordings need to change, but it shouldn't be because of a breaking change.
Additional comments:
- When should we be running live tests? We should add a guideline for this - at least before every GA release, and use different service API versions.
- Maybe we should establish guidelines on when to mock, with the default to not mock. e.g. fault injection appears to be one area where we heavily rely on mocks
- Who needs to decide what "appropriate" code coverage is actually reasonable. There should be a test for every single publically exposed operation. Also, error handling needs to be tested. Focus on clients rather than models. Payloads that can be serialized and deserialized should be tested.
- Reaching 100% code coverage is next to impossible - how do you select what to add to improve coverage.
- One guidelines that might be added regarding recordings is that perhaps you should exclude sensitive information from the recording.
from sdk.
Completed and merged into general guidelines.
from sdk.
Related Issues (20)
- Board Review: Management Plane Namespace Review mongocluster HOT 8
- Azure SDK Review - [IC3 ACS Calling] HOT 2
- Azure SDK Review - [IC3 ACS Calling] HOT 2
- Board Review: <client library name> HOT 1
- Azure SDK Review - [Introduction to IC3 ACS Server Calling] HOT 2
- Azure SDK Review - [Azure Identity] HOT 4
- Azure SDK Review - [IC3 ACS Rooms] HOT 2
- As Microsoft pays so much attention to Rust, why is there not Azure SDK for Rust HOT 2
- Azure SDK Review - [Azure AI Translator] HOT 4
- Azure SDK Review - [Introduction to MaaS Client Library (SDK)] HOT 4
- Azure SDK Review - [Introduction to Health Data DeIdentification]
- Azure SDK Review - [Introduction to Batch] HOT 1
- Change Request: Provide a complete guideline for Go HOT 2
- Board Review: Management Plane Namespace Review SplitIOExperimentation HOT 12
- Board Review: Event Hubs Geo-Disaster Recovery HOT 1
- Azure SDK Review - [AzureML - Inferencing] HOT 1
- Azure SDK Review - [AzureML - Inferencing]
- k4a_image_get_size() returns un-expected values HOT 3
- Azure SDK Review - [Introduction to ACS Chat UI] HOT 1
- Azure SDK Review - [Azure SDK - Cosmos DB Python SDK]
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from sdk.