4. The Zanebug VS.NET 2003 Add-in

The Zanebug VS.NET Add-in allows integration of Zanebug into the VS.NET 2003 IDE.

4.1. Installation / Removal

Installing the VS.NET Add-in can be done in two ways:

4.1.1. Installation / Removal with Zanebug

As part of the standard installation, you'll be provided with the option to install VS.NET 2003 Add-in. Simply keep this item checked, and the Add-in will install silently.

Important

You should close all running instances of VS.NET prior to running this step. If you don't, the Addin won't appear and you'll need to manually display it via the Add-In Manager.

Figure 9. Option to Install Zanebug VS.NET 2003 Addin

Option to Install Zanebug VS.NET 2003 Addin

When you uninstall Zanebug (Start -> Programs -> Zanebug -> Uninstall), the Add-in will be automatically uninstalled.

4.1.2. Manual Installation / Removal

Option A: Run Control Panel Uninstaller

You can manually uninstall Zanebug by going to Control Panel -> Add Remove Programs -> ZanebugAddin

Figure 10. Uninstalling ZanebugAddin via the Control Panel

Uninstalling ZanebugAddin via the Control Panel

Option B: Run Program Uninstaller

At any time, you can manually install or uinstall the Add-in. To manually install, go to the Zanebug install directory (default is C:\Program Files\Zanebug) and click on the Setup.msi. This will launch the Add-in installer. To uninstall, do the same thing, and it will launch the uninstall process. To uninstall, you can also go to the Add/Remove Programs section in Control Panel and select ZanebugAddinSetup.

Troubleshooting

If for some reason the Zanebug Add-in doesn't uninstall properly, do the following:

  1. Open the registry and delete the following key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.1\AddIns\ZanebugAddin.Connect

    This removes the VS.NET entry for the Zanebug Addin.

  2. Open the VS.NET 2003 Command Prompt (Start -> Programs -> Microsoft Visual Studio .NET 2003 -> Visual Studio .NET Tools -> Visual Studio 2003 Command Prompt) and enter the following:

    devenv /setup

    This resets the VS.NET Command Bar information.

    Note

    This will reset the command bars to their default mode, so you may have to reselect some toolbars for display.

4.2. Usage

Usage of the Add-in is straight forward. Select one of the options below to run tests.

Cursor Location

The way Zanebug decides what to run is by the cursor location::

  • If the cursor is inside a Test method, it will run that specific Test

  • If the cursor is between Test methods, it will run the Test method above the cursor

  • If the cursor is at the TestFixture declaration, it will run the entire TestFixture

4.2.1. Zanebug Context Menu

When viewing code in the Code Window, you can right click for the Context Menu. On the Context Menu, you'll see "Test with Zanebug". Place the cursor in the proper location and click this to run Zanebug.

Figure 11. Context Menu Option

Context Menu Option

4.2.2. Zanebug Toolbar Command

When you install the Add-in, it creates a Toolbar for Zanebug. This should be visible the next time you open VS.NET IDE. By default, the Zanebug toolbar is undocked.

Tip

If the toolbar isn't visible, go to the VS.NET menu and select View -> Toolbars -> Zanebug (should be checked).

Figure 12. Toolbar Option (Undocked - Default)

Toolbar Option (Undocked - Default)

To dock it, simply drag it to the VS.NET toolbar.

Figure 13. Toolbar Option (Docked)

Toolbar Option (Docked)

Alt + Z

If the Zanebug toolbar is visible on your screen, you can simply place your cursor in the code window at the correct location and press Alt + Z to run your test. This saves you from having to pull up the Context Menu or go to the Toolbar.