From 4ac85d299513e6a40415f2332ed19886e7fd9ff6 Mon Sep 17 00:00:00 2001 From: Frode Flaten <3436158+fflaten@users.noreply.github.com> Date: Sat, 8 Jun 2024 15:32:20 +0000 Subject: [PATCH 1/5] Update VSCode page --- docs/usage/images/vscode-outline.png | Bin 0 -> 6214 bytes docs/usage/vscode.mdx | 26 ++++++++++++++++---------- 2 files changed, 16 insertions(+), 10 deletions(-) create mode 100644 docs/usage/images/vscode-outline.png diff --git a/docs/usage/images/vscode-outline.png b/docs/usage/images/vscode-outline.png new file mode 100644 index 0000000000000000000000000000000000000000..7dbb3d443c377a3142d3405c9aa1177a875518ff GIT binary patch literal 6214 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 literal 0 HcmV?d00001 diff --git a/docs/usage/vscode.mdx b/docs/usage/vscode.mdx index 9ee5cae4..de979e09 100644 --- a/docs/usage/vscode.mdx +++ b/docs/usage/vscode.mdx @@ -1,25 +1,31 @@ --- -title: VSCode +title: Visual Studio Code description: See how Visual Studio Code and its extensions helps you run and debug your Pester tests directly inside the editor --- -### VSCode improvements +Using Visual Studio Code with the latest [PowerShell extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.PowerShell) is a great combination for writing PowerShell code. The extenstion even includes a few Pester-specific features to improve the way you write, run and debug Pester tests. -#### Use legacy code lens +### Code lens -With Pester 5 it is finally possible to run and debug just a single test in VSCode! +With the `Pester: Code Lens` setting enabled, VSCode will show `Run tests` or `Debug tests` links above your Pester blocks for quick execution. Starting with Pester 5 this also works on individual tests. You can even run tests that are marked as skipped by running them individually. ![Shows a single test being run using the new Code Lens](images/single-test.gif) -In the latest [PowerShell](https://marketplace.visualstudio.com/items?itemName=ms-vscode.PowerShell) extension for VSCode you can enable Use Legacy Code Lens option which will enable `Run tests` on all `Describe`, `Context` and `It` blocks. You can run a whole block, any child block, or any test individually. You can also run tests that are marked as skipped by running them individually. +To enable the improved code lens for Pester 5 you need to disable the "Use Legacy Code Lens" setting which is enabled by default. -Actually there is a bug, and the option is called Enable Legacy Code Lens, and is enabled by default and should be disabled for Pester 5. 😁 Take advantage of this and go try it right now! +1. In Visual Studio Code, open **File | Preferences | Settings** (⌘/Ctrl + ,) +2. In the **Settings** window, navigate to the **Extensions | PowerShell** section. +3. Uncheck the **Pester: Use Legacy Code Lens** checkbox. +4. Close the **Settings** window. -**Instructions:** In Visual Studio Code, select **File | Preferences | Settings** (or type **Ctrl+,**). In the **Settings** window, under the **User** tab, select **Extensions | PowerShell Configuration**. Uncheck the **Pester: Use Legacy Code Lens** checkbox. Close the **Settings** window. +### Output verbosity +You can control the output verbosity level in VSCode output, or let it inherit from PesterPreference. -#### Output verbosity +![Shows a run with normal preference that shows only errors](images/minimal-output.gif) -You can specify verbosity in VSCode, to see normal or detailed output, or to take it from PesterPreference. This also works for Pester 4! +### Outline view -![Shows a run with normal preference that shows only errors](images/minimal-output.gif) +You can easily navigate larger tests files using the Outline view. This includes all your Pester blocks, tests and setup/teardown as you'd expect. + +![Shows a outline of Pester block structure in the sidepanel](images/vscode-outline.png) From dbd29d8ee4ba7296031e62700e3adf1d89953abc Mon Sep 17 00:00:00 2001 From: Frode Flaten <3436158+fflaten@users.noreply.github.com> Date: Sat, 8 Jun 2024 15:48:40 +0000 Subject: [PATCH 2/5] Include navigation features in VSCode --- docs/usage/images/vscode-breadcrumbs.png | Bin 0 -> 13667 bytes docs/usage/images/vscode-symbol.png | Bin 0 -> 2475 bytes docs/usage/vscode.mdx | 12 ++++++++++-- 3 files changed, 10 insertions(+), 2 deletions(-) create mode 100644 docs/usage/images/vscode-breadcrumbs.png create mode 100644 docs/usage/images/vscode-symbol.png diff --git a/docs/usage/images/vscode-breadcrumbs.png b/docs/usage/images/vscode-breadcrumbs.png new file mode 100644 index 0000000000000000000000000000000000000000..e0a632c777595ec9a4290bd73682aa06fb85e84c GIT binary patch literal 13667 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 HJmmiZMwLuU literal 0 HcmV?d00001 diff --git a/docs/usage/images/vscode-symbol.png b/docs/usage/images/vscode-symbol.png new file mode 100644 index 0000000000000000000000000000000000000000..37fa0173f010938197580cad7b6fac7a43eba0a7 GIT binary patch literal 2475 zcmV;c2~_rpP)r6+DxEexp`@xhL8_raNld5u$K=m2gSX7kTuD=%%-7`2JwZvvqCG>M`klz=IzgF$xZT&dimI-%NO4I>r}{cUwK{R$#^l~p zkhPhdqqBoO#^lZ7$flvn=u@ZOKtV}8g74Sk=-9iFt+BQ+Hj1{1NkEYL;^N+hyWZl; zsy145;^fbOHa!*@9JJZ!I;PL!*}TW(=(XD3Frv*PSF<@lM=>`(Izf@grb#hTYI9&t z-P6t8;^@ZK=b=HWl9--Mf|-?qY9l#gEJTY;IzeG^SUgjm@4VUQzsc9L+0AR7$w!sQiKM?zjK9y> zyr!zKIzgbtw4P6DjI5W3I%0>9mV&m7UWRI3mO)8LA|=P<*|WIKoubXy%D=P7ytAUb zcAUCQg0*{>w2`E$WsIt}q>;wBif?p#T5@+X#$O%2{IocM+rB!Ce%clh9=Acgd8Q@ z)#gje%vjo2$l@LK^Br8qu0gujX_0nK~Yi_xF&7`jAG-#|hUiEubJ+u=~N@I~ME}1S|G`>wDh0yA$1*M6)(L z4>y~coim%jeeOAPlimHLrpev;##d26)igy-Q~p7|Ynoo~sgRPd_bi&G*RU(4U&G$n zG({;DHBIS)nx_1tsA|zk%Y%ahAsi{nO*Mn(OmUz=P`~uT> zoIy<^PEG4=TJP$~sUf`-a~gnNWcFO&I_OQij4~+-(ll7tZW=@r)q-h0nDc#Hchi!z zUU$a2MtZhhkAg-PJ*lLrYau`y!8cB_D2uHFGH4n$38rykgrC#taLwcxkH8nRXvLT- zuG+IrIdFu-sc8e`v;j<8?GqYJgE(BEWu|2XbunY0AcBKwGiRaADDLx|m@~Xw+xXS$ zsTIR2u@0s+t!dnfGt;cYlS6}P3wv_KTowXBD^FAjA)LV` zT(lA1fabK{ZJMv1VwynHxEx!bn9-C!&WRz6y{YJ&aosP2*g_@(^#+G*Q$3m}y+? zd(%Xo+%(xjqi=GW1mF=&!&sM`7EJRl6ikCjKJ}%E$i&7sISsQ~F$P7DV49y;Gz~pA zS*rcq+_VG+YxOMAwE0(_9Xf2xJ3Q_lJMy8cX;{#M1>Q6vtkXDPz;Lny%x55&hWUN1 z(~^`5NcD86o-~Km(;9*{P2Z{zO~WnvX3v{Xrf(?JKombuD?;^tj>wrJ)Tlf=k)*p002ovPDHLkV1n`#!7l&+ literal 0 HcmV?d00001 diff --git a/docs/usage/vscode.mdx b/docs/usage/vscode.mdx index de979e09..27d46a6e 100644 --- a/docs/usage/vscode.mdx +++ b/docs/usage/vscode.mdx @@ -24,8 +24,16 @@ You can control the output verbosity level in VSCode output, or let it inherit f ![Shows a run with normal preference that shows only errors](images/minimal-output.gif) -### Outline view +### Navigation -You can easily navigate larger tests files using the Outline view. This includes all your Pester blocks, tests and setup/teardown as you'd expect. +Pester-blocks are recognized by the PowerShell-extenstion to simplify navigation in your test files. You can see the strcuture of your Pester file using the Outline view. ![Shows a outline of Pester block structure in the sidepanel](images/vscode-outline.png) + +Your current location in nested blocks are shown in the breadcrumbs and sticky scroll features: + +![Shows nested blocks as sticky lines above the current line in the editor](images/vscode-breadcrumbs.png) + +`Context`, `Describe` and `It` blocks are all searchable using Go to symbol commands + +![Shows a search result for Help is found-test using the Go To Symbol in Workspace command](images/vscode-symbol.png) From 7fc394c519d0dec48f00238bf9c4eb43ca7699a2 Mon Sep 17 00:00:00 2001 From: Frode Flaten <3436158+fflaten@users.noreply.github.com> Date: Sat, 8 Jun 2024 15:53:16 +0000 Subject: [PATCH 3/5] Fix typos --- docs/usage/vscode.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/usage/vscode.mdx b/docs/usage/vscode.mdx index 27d46a6e..03651ee8 100644 --- a/docs/usage/vscode.mdx +++ b/docs/usage/vscode.mdx @@ -3,7 +3,7 @@ title: Visual Studio Code description: See how Visual Studio Code and its extensions helps you run and debug your Pester tests directly inside the editor --- -Using Visual Studio Code with the latest [PowerShell extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.PowerShell) is a great combination for writing PowerShell code. The extenstion even includes a few Pester-specific features to improve the way you write, run and debug Pester tests. +Using Visual Studio Code with the latest [PowerShell extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.PowerShell) provides a great experience for writing PowerShell code. The extension includes Pester-specific features to improve the way you write, run and debug Pester tests. ### Code lens @@ -26,7 +26,7 @@ You can control the output verbosity level in VSCode output, or let it inherit f ### Navigation -Pester-blocks are recognized by the PowerShell-extenstion to simplify navigation in your test files. You can see the strcuture of your Pester file using the Outline view. +Pester-blocks are recognized by the PowerShell-extension to simplify navigation in your test files. You can see the strcuture of your Pester file using the Outline view. ![Shows a outline of Pester block structure in the sidepanel](images/vscode-outline.png) From 5bc6c3c3ba54d72d0918041986333f6902e9c5ae Mon Sep 17 00:00:00 2001 From: Frode Flaten <3436158+fflaten@users.noreply.github.com> Date: Sat, 8 Jun 2024 15:56:49 +0000 Subject: [PATCH 4/5] Use list for navigation features --- docs/usage/vscode.mdx | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/docs/usage/vscode.mdx b/docs/usage/vscode.mdx index 03651ee8..7f1bceea 100644 --- a/docs/usage/vscode.mdx +++ b/docs/usage/vscode.mdx @@ -26,14 +26,13 @@ You can control the output verbosity level in VSCode output, or let it inherit f ### Navigation -Pester-blocks are recognized by the PowerShell-extension to simplify navigation in your test files. You can see the strcuture of your Pester file using the Outline view. +Pester-blocks are recognized by the PowerShell-extension to simplify navigation in your test files. -![Shows a outline of Pester block structure in the sidepanel](images/vscode-outline.png) +- The Outline panle shows an overview of your Pester-blocks.
+ ![Shows a outline of Pester block structure in the sidepanel](images/vscode-outline.png) -Your current location in nested blocks are shown in the breadcrumbs and sticky scroll features: +- Your current location in easily identified using breadcrumbs or the sticky scroll features.
+ ![Shows nested blocks as sticky lines above the current line in the editor](images/vscode-breadcrumbs.png) -![Shows nested blocks as sticky lines above the current line in the editor](images/vscode-breadcrumbs.png) - -`Context`, `Describe` and `It` blocks are all searchable using Go to symbol commands - -![Shows a search result for Help is found-test using the Go To Symbol in Workspace command](images/vscode-symbol.png) +- `Context`, `Describe` and `It` blocks are all searchable using Go to symbol commands.
+ ![Shows a search result for Help is found-test using the Go To Symbol in Workspace command](images/vscode-symbol.png) From 91129d5344db49a1fff12e4cc949d851e92fe801 Mon Sep 17 00:00:00 2001 From: Frode Flaten <3436158+fflaten@users.noreply.github.com> Date: Sun, 17 Nov 2024 14:23:46 +0000 Subject: [PATCH 5/5] Copy to v5 docs --- .../usage/images/vscode-breadcrumbs.png | Bin 0 -> 13667 bytes .../usage/images/vscode-outline.png | Bin 0 -> 6214 bytes .../version-v5/usage/images/vscode-symbol.png | Bin 0 -> 2475 bytes versioned_docs/version-v5/usage/vscode.mdx | 32 +++++++++++++----- 4 files changed, 24 insertions(+), 8 deletions(-) create mode 100644 versioned_docs/version-v5/usage/images/vscode-breadcrumbs.png create mode 100644 versioned_docs/version-v5/usage/images/vscode-outline.png create mode 100644 versioned_docs/version-v5/usage/images/vscode-symbol.png diff --git a/versioned_docs/version-v5/usage/images/vscode-breadcrumbs.png b/versioned_docs/version-v5/usage/images/vscode-breadcrumbs.png new file mode 100644 index 0000000000000000000000000000000000000000..e0a632c777595ec9a4290bd73682aa06fb85e84c GIT binary patch literal 13667 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 HJmmiZMwLuU literal 0 HcmV?d00001 diff --git a/versioned_docs/version-v5/usage/images/vscode-outline.png b/versioned_docs/version-v5/usage/images/vscode-outline.png new file mode 100644 index 0000000000000000000000000000000000000000..7dbb3d443c377a3142d3405c9aa1177a875518ff GIT binary patch literal 6214 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 literal 0 HcmV?d00001 diff --git a/versioned_docs/version-v5/usage/images/vscode-symbol.png b/versioned_docs/version-v5/usage/images/vscode-symbol.png new file mode 100644 index 0000000000000000000000000000000000000000..37fa0173f010938197580cad7b6fac7a43eba0a7 GIT binary patch literal 2475 zcmV;c2~_rpP)r6+DxEexp`@xhL8_raNld5u$K=m2gSX7kTuD=%%-7`2JwZvvqCG>M`klz=IzgF$xZT&dimI-%NO4I>r}{cUwK{R$#^l~p zkhPhdqqBoO#^lZ7$flvn=u@ZOKtV}8g74Sk=-9iFt+BQ+Hj1{1NkEYL;^N+hyWZl; zsy145;^fbOHa!*@9JJZ!I;PL!*}TW(=(XD3Frv*PSF<@lM=>`(Izf@grb#hTYI9&t z-P6t8;^@ZK=b=HWl9--Mf|-?qY9l#gEJTY;IzeG^SUgjm@4VUQzsc9L+0AR7$w!sQiKM?zjK9y> zyr!zKIzgbtw4P6DjI5W3I%0>9mV&m7UWRI3mO)8LA|=P<*|WIKoubXy%D=P7ytAUb zcAUCQg0*{>w2`E$WsIt}q>;wBif?p#T5@+X#$O%2{IocM+rB!Ce%clh9=Acgd8Q@ z)#gje%vjo2$l@LK^Br8qu0gujX_0nK~Yi_xF&7`jAG-#|hUiEubJ+u=~N@I~ME}1S|G`>wDh0yA$1*M6)(L z4>y~coim%jeeOAPlimHLrpev;##d26)igy-Q~p7|Ynoo~sgRPd_bi&G*RU(4U&G$n zG({;DHBIS)nx_1tsA|zk%Y%ahAsi{nO*Mn(OmUz=P`~uT> zoIy<^PEG4=TJP$~sUf`-a~gnNWcFO&I_OQij4~+-(ll7tZW=@r)q-h0nDc#Hchi!z zUU$a2MtZhhkAg-PJ*lLrYau`y!8cB_D2uHFGH4n$38rykgrC#taLwcxkH8nRXvLT- zuG+IrIdFu-sc8e`v;j<8?GqYJgE(BEWu|2XbunY0AcBKwGiRaADDLx|m@~Xw+xXS$ zsTIR2u@0s+t!dnfGt;cYlS6}P3wv_KTowXBD^FAjA)LV` zT(lA1fabK{ZJMv1VwynHxEx!bn9-C!&WRz6y{YJ&aosP2*g_@(^#+G*Q$3m}y+? zd(%Xo+%(xjqi=GW1mF=&!&sM`7EJRl6ikCjKJ}%E$i&7sISsQ~F$P7DV49y;Gz~pA zS*rcq+_VG+YxOMAwE0(_9Xf2xJ3Q_lJMy8cX;{#M1>Q6vtkXDPz;Lny%x55&hWUN1 z(~^`5NcD86o-~Km(;9*{P2Z{zO~WnvX3v{Xrf(?JKombuD?;^tj>wrJ)Tlf=k)*p002ovPDHLkV1n`#!7l&+ literal 0 HcmV?d00001 diff --git a/versioned_docs/version-v5/usage/vscode.mdx b/versioned_docs/version-v5/usage/vscode.mdx index a03527c3..7f1bceea 100644 --- a/versioned_docs/version-v5/usage/vscode.mdx +++ b/versioned_docs/version-v5/usage/vscode.mdx @@ -1,22 +1,38 @@ --- -title: VSCode +title: Visual Studio Code description: See how Visual Studio Code and its extensions helps you run and debug your Pester tests directly inside the editor --- -### VSCode improvements +Using Visual Studio Code with the latest [PowerShell extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.PowerShell) provides a great experience for writing PowerShell code. The extension includes Pester-specific features to improve the way you write, run and debug Pester tests. -#### Use legacy code lens +### Code lens -With Pester 5 it is finally possible to run and debug just a single test in VSCode! +With the `Pester: Code Lens` setting enabled, VSCode will show `Run tests` or `Debug tests` links above your Pester blocks for quick execution. Starting with Pester 5 this also works on individual tests. You can even run tests that are marked as skipped by running them individually. ![Shows a single test being run using the new Code Lens](images/single-test.gif) -In the latest [PowerShell](https://marketplace.visualstudio.com/items?itemName=ms-vscode.PowerShell) extension for VSCode you can enable Use Legacy Code Lens option which will enable `Run tests` on all `Describe`, `Context` and `It` blocks. You can run a whole block, any child block, or any test individually. You can also run tests that are marked as skipped by running them individually. +To enable the improved code lens for Pester 5 you need to disable the "Use Legacy Code Lens" setting which is enabled by default. -Actually there is a bug, and the option is called Enable Legacy Code Lens, and is enabled by default and should be disabled for Pester 5. 😁 Take advantage of this and go try it right now! +1. In Visual Studio Code, open **File | Preferences | Settings** (⌘/Ctrl + ,) +2. In the **Settings** window, navigate to the **Extensions | PowerShell** section. +3. Uncheck the **Pester: Use Legacy Code Lens** checkbox. +4. Close the **Settings** window. -#### Output verbosity +### Output verbosity -You can specify verbosity in VSCode, to see normal or detailed output, or to take it from PesterPreference. This also works for Pester 4! +You can control the output verbosity level in VSCode output, or let it inherit from PesterPreference. ![Shows a run with normal preference that shows only errors](images/minimal-output.gif) + +### Navigation + +Pester-blocks are recognized by the PowerShell-extension to simplify navigation in your test files. + +- The Outline panle shows an overview of your Pester-blocks.
+ ![Shows a outline of Pester block structure in the sidepanel](images/vscode-outline.png) + +- Your current location in easily identified using breadcrumbs or the sticky scroll features.
+ ![Shows nested blocks as sticky lines above the current line in the editor](images/vscode-breadcrumbs.png) + +- `Context`, `Describe` and `It` blocks are all searchable using Go to symbol commands.
+ ![Shows a search result for Help is found-test using the Go To Symbol in Workspace command](images/vscode-symbol.png)