#detection #query #visual-studio #vs2017

build vswhere

Provides support for invoking and capturing the output of the vswhere utility

1 unstable release

Uses old Rust 2015

0.1.0 Jun 30, 2018

#533 in Build Utils

Apache-2.0 OR MIT

514 lines


Travis CI AppVeyor Crates.io Docs.rs

Provides support for invoking and capturing the output of the vswhere utility.


Starting with the 2017 editions, Visual Studio products support side-by-side installation. This means that the Windows registry is no longer sufficient for storing information about installed Visual Studio instances, and a more sophisticated detection method is required. vswhere is an open-source utility from Microsoft that consumes a COM-based query API and generates output in one of several formats (text, JSON, XML). Through this crate, Rust code can pass arguments to, invoke and retrieve output from vswhere in an idiomatic manner.


This crate works with vswhere 2.5.2 or newer. Older versions are not supported since they do not accept the -utf8 flag, which forces vswhere to generate UTF-8 encoded output (otherwise vswhere uses the system default encoding). vswhere can be installed in one of three different ways:

  • Via Chocolatey (recommended - package page here);
  • As part of Visual Studio Installer (vswhere.exe will be located in %ProgramFiles(x86)%\Microsoft Visual Studio\Installer - note that the bundled version tends to be outdated);
  • Manually, by downloading vswhere.exe to the desired location.


extern crate vswhere;

use vswhere::Config;

fn main() {
    println!("{:?}", Config::run_default_path().unwrap());


Licensed under either of

at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


~22K SLoC