Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: explain multi suite session #219

Merged
Merged
Changes from all commits
Commits
Show all changes
19 commits
Select commit Hold shift + click to select a range
c07d3e9
pr-fix: correct merge w/ 'main'
stijnmoreels Aug 2, 2024
6b26d6d
Merge branch 'main' of https://github.com/stijnmoreels/arcus.testing
stijnmoreels Aug 2, 2024
0de9e56
Merge remote-tracking branch 'upstream/main'
stijnmoreels Aug 26, 2024
cbfd3d9
Merge remote-tracking branch 'upstream/main'
stijnmoreels Sep 6, 2024
cc62c4b
Merge remote-tracking branch 'upstream/main'
stijnmoreels Sep 13, 2024
7ad43ef
Merge remote-tracking branch 'upstream/main'
stijnmoreels Sep 23, 2024
483f449
Merge remote-tracking branch 'upstream/main'
stijnmoreels Sep 27, 2024
b496a00
Merge remote-tracking branch 'upstream/main'
stijnmoreels Oct 10, 2024
be1dc25
Merge remote-tracking branch 'upstream/main'
stijnmoreels Oct 18, 2024
6968cb5
Merge remote-tracking branch 'upstream/main'
stijnmoreels Oct 18, 2024
b0b1e6d
Merge remote-tracking branch 'upstream/main'
stijnmoreels Oct 18, 2024
6080add
Merge remote-tracking branch 'upstream/main'
stijnmoreels Oct 23, 2024
42cdd3d
Merge remote-tracking branch 'upstream/main'
stijnmoreels Oct 28, 2024
3c67e9a
Merge remote-tracking branch 'upstream/main'
stijnmoreels Oct 28, 2024
c25ca9c
Merge remote-tracking branch 'upstream/main'
stijnmoreels Oct 29, 2024
b94ed50
chore: eat your own logging dog food
stijnmoreels Nov 1, 2024
f00adf4
Merge remote-tracking branch 'upstream/main'
stijnmoreels Nov 1, 2024
0536b9d
docs: explain multi-suite active session id
stijnmoreels Nov 4, 2024
a9454df
Merge branch 'arcus-azure:main' into docs/explain-multi-suite-session-id
stijnmoreels Nov 4, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 10 additions & 1 deletion docs/preview/02-Features/06-Integration/01-data-factory.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,16 @@ await TemporaryDataFlowDebugSession.StartDebugSessionAsync(..., options =>
});
```

> 💡 The `ActiveSessionId` is useful when developing locally when you do not want to start/stop the debug session on every run. But this also means that in case an active session is found, it will not be teardown when the test fixture disposes. This follows the 'clean environment' principle that test fixtures should only be responsible for the things they set up.
> #### 💡 Leveraging the `ActiveSessionId` option
> The `ActiveSessionId` is useful when developing locally when you do not want to start/stop the debug session on every run. But this also means that in case an active session is found, it will not be teardown when the test fixture disposes. This follows the 'clean environment' principle that test fixtures should only be responsible for the things they set up.
>
> ⚡ Because of this functionality, you can even use the same debug session across different test suites/projects. These things need to happen to set this up:
>
> 1. Run a **custom script** task before any of the test suites to start a debug session.
> 2. Set a new **pipeline variable with the session ID** of the active debug session.
> 3. Get the pipeline variable in your tests suites to assign it to the `ActiveSessionId` option.
> 4. Run a custom script after all the test suites to stop the debug session.
> * ⚠️ **_Make sure that this always runs, even if the tests fail._**

### Full example
The following snippet provides a full examples of how the `TemporaryDataFlowDebugSession` test fixture can be used as a singleton test fixture across tests.
Expand Down
Loading