Makeprojects
Loading...
Searching...
No Matches
makeprojects.visual_studio Namespace Reference

Project file generator for Microsoft Visual Studio 2003-2008. More...

Classes

class  BuildVisualStudioFile
 Class to build Visual Studio files. More...
class  VCALinkTool
 Visual Studio 2003-2008 for VCALinkTool. More...
class  VCAppVerifierTool
 Visual Studio 2003-2008 for VCAppVerifierTool. More...
class  VCAuxiliaryManagedWrapperGeneratorTool
 Visual Studio 2003-2008 for VCAuxiliaryManagedWrapperGeneratorTool. More...
class  VCBscMakeTool
 Visual Studio 2003-2008 for VCBscMakeTool. More...
class  VCCLCompilerTool
 Visual Studio 2003-2008 VCCLCompilerTool record. More...
class  VCCLCompilerToolFile
 Visual Studio 2003-2008 VCCLCompilerTool record for file. More...
class  VCCustomBuildTool
 Visual Studio 2003-2008 VCCustomBuildTool record. More...
class  VCFxCopTool
 Visual Studio 2003-2008 for VCFxCopTool. More...
class  VCGLSLTool
 Visual Studio 2005-2008 GLSL record. More...
class  VCHLSLTool
 Visual Studio 2005-2008 HLSL record. More...
class  VCLibrarianTool
 Visual Studio 2003-2008 for VCLibrarianTool. More...
class  VCLinkerTool
 Visual Studio 2003-2008 VCLinkerTool. More...
class  VCManagedResourceCompilerTool
 Visual Studio 2003-2008 for VCManagedResourceCompilerTool. More...
class  VCManagedWrapperGeneratorTool
 Visual Studio 2003-2008 for VCManagedWrapperGeneratorTool. More...
class  VCManifestTool
 Visual Studio 2003-2008 for VCManifestTool. More...
class  VCMASM64Tool
 Visual Studio 2005-2008 MASM64 record. More...
class  VCMASMTool
 Visual Studio 2005-2008 MASM record. More...
class  VCMIDLTool
 Visual Studio 2003-2008 for the MIDL tool. More...
class  VCPostBuildEventTool
 Visual Studio 2003-2008 for VCPostBuildEventTool. More...
class  VCPreBuildEventTool
 Visual Studio 2003-2008 for VCPreBuildEventTool. More...
class  VCPreLinkEventTool
 Visual Studio 2003-2008 for VCPreLinkEventTool. More...
class  VCResourceCompilerTool
 Visual Studio 2003-2008 for VCResourceCompilerTool. More...
class  VCWebDeploymentTool
 Visual Studio 2003-2008 for VCWebDeploymentTool. More...
class  VCWebServiceProxyGeneratorTool
 Visual Studio 2003-2008 for VCWebServiceProxyGeneratorTool. More...
class  VCXDCMakeTool
 Visual Studio 2003-2008 for VCXDCMakeTool. More...
class  VCXMLDataGeneratorTool
 Visual Studio 2003-2008 for VCXMLDataGeneratorTool. More...
class  VS2003Configuration
 Visual Studio 2003-2008 Configuration record. More...
class  VS2003Configurations
 Visual Studio 2003-2008 Configurations record. More...
class  VS2003File
 Visual Studio 2003-2008 File record. More...
class  VS2003FileConfiguration
 Visual Studio 2003-2008 Configurations record. More...
class  VS2003Files
 Visual Studio 2003-2008 Files record. More...
class  VS2003Filter
 Visual Studio 2003-2008 File record. More...
class  VS2003Globals
 Visual Studio 2003-2008 Globals record. More...
class  VS2003Platform
 Visual Studio 2003-2008 Platform record. More...
class  VS2003Platforms
 Visual Studio 2003-2008 Platforms record. More...
class  VS2003References
 Visual Studio 2003-2008 References record. More...
class  VS2003Tool
 Helper class to output a Tool record for Visual Studio 2003-2008. More...
class  VS2003ToolFile
 Visual Studio 2005-2008 Tool record. More...
class  VS2003ToolFiles
 Visual Studio 2003-2008 ToolFiles record. More...
class  VS2003vcproj
 Visual Studio 2003-2008 formatter. More...
class  VS2003XML
 Visual Studio 2003-2008 XML formatter. More...
class  XboxDeploymentTool
 XboxDeploymentTool for Xbox Classic. More...
class  XboxImageTool
 XboxImageTool for Xbox Classic. More...

Functions

 parse_sln_file (full_pathname)
 Find build targets in .sln file.
 match (filename)
 Check if the filename is a type that this module supports.
 create_build_object (file_name, priority=50, configurations=None, verbose=False)
 Create BuildVisualStudioFile build records for every desired configuration.
 create_clean_object (file_name, priority=50, configurations=None, verbose=False)
 Create BuildVisualStudioFile clean records for every desired configuration.
 test (ide, platform_type)
 Filter for supported platforms.
 ExcludedFromBuild (fallback=None)
 Create ExcludedFromBuild property.
 Name (fallback)
 Create Name property.
 OutputDirectory (configuration, fallback=None)
 Create OutputDirectory property.
 IntermediateDirectory (configuration, fallback=None)
 Create IntermediateDirectory property.
 ConfigurationType (configuration, fallback=None)
 Create ConfigurationType property.
 UseOfMFC (configuration, fallback=None)
 Create UseOfMFC property.
 UseOfATL (configuration, fallback=None)
 Create UseOfATL property.
 ATLMinimizesCRunTimeLibraryUsage (configuration, fallback=None)
 Create ATLMinimizesCRunTimeLibraryUsage property.
 CharacterSet (configuration, fallback=None)
 Create CharacterSet property.
 ManagedExtensions (configuration, fallback=None)
 Create ManagedExtensions property.
 DeleteExtensionsOnClean (configuration, fallback=None)
 Create DeleteExtensionsOnClean property.
 WholeProgramOptimization (configuration, fallback=None)
 Create WholeProgramOptimization property.
 ReferencesPath (configuration, fallback=None)
 Create ReferencesPath property.
 UseUnicodeResponseFiles (configuration, prefix=None)
 Create UseUnicodeResponseFiles property.
 AdditionalOptions (configuration, fallback=None, prefix=None)
 Create AdditionalOptions property.
 Optimization (configuration, fallback=None)
 Create Optimization property.
 GlobalOptimizations (configuration, fallback=None)
 Create GlobalOptimizations property.
 InlineFunctionExpansion (configuration, fallback=None)
 Create InlineFunctionExpansion property.
 EnableIntrinsicFunctions (configuration, fallback=None)
 Create EnableIntrinsicFunctions property.
 ImproveFloatingPointConsistency (configuration, fallback=None)
 Create ImproveFloatingPointConsistency property.
 FavorSizeOrSpeed (configuration, fallback=None)
 Create FavorSizeOrSpeed property.
 OmitFramePointers (configuration, fallback=None)
 Create OmitFramePointers property.
 EnableFiberSafeOptimizations (configuration, fallback=None)
 Create EnableFiberSafeOptimizations property.
 OptimizeForProcessor (configuration, fallback=None)
 Create OptimizeForProcessor property.
 OptimizeForWindowsApplication (configuration, fallback=None)
 Create OptimizeForWindowsApplication property.
 WholeProgramOptimization2003 (configuration, fallback=None)
 Create WholeProgramOptimization property for VS 2003.
 AdditionalIncludeDirectories (configuration, fallback=None)
 Create AdditionalIncludeDirectories property.
 AdditionalUsingDirectories (configuration, fallback=None)
 Create AdditionalUsingDirectories property.
 PreprocessorDefinitions (configuration, fallback=None)
 Create PreprocessorDefinitions property.
 IgnoreStandardIncludePath (configuration, fallback=None)
 Create IgnoreStandardIncludePath property.
 GeneratePreprocessedFile (configuration, fallback=None)
 Create GeneratePreprocessedFile property.
 KeepComments (configuration, fallback=None)
 Create KeepComments property.
 StringPooling (configuration, fallback=None)
 Create StringPooling property.
 MinimalRebuild (configuration, fallback=None)
 Create MinimalRebuild property.
 ExceptionHandling (configuration, fallback=None)
 Create ExceptionHandling property.
 BasicRuntimeChecks (configuration, fallback=None)
 Create BasicRuntimeChecks property.
 SmallerTypeCheck (configuration, fallback=None)
 Create SmallerTypeCheck property.
 RuntimeLibrary (configuration, fallback=None)
 Create RuntimeLibrary property.
 StructMemberAlignment (configuration, fallback=None)
 Create StructMemberAlignment property.
 BufferSecurityCheck (configuration, fallback=None)
 Create BufferSecurityCheck property.
 EnableFunctionLevelLinking (configuration, fallback=None)
 Create EnableFunctionLevelLinking property.
 EnableEnhancedInstructionSet (configuration, fallback=None)
 Create EnableEnhancedInstructionSet property.
 FloatingPointModel (configuration, fallback=None)
 Create FloatingPointModel property.
 FloatingPointExceptions (configuration, fallback=None)
 Create FloatingPointExceptions property.
 DisableLanguageExtensions (configuration, fallback=None)
 Create DisableLanguageExtensions property.
 DefaultCharIsUnsigned (configuration, fallback=None)
 Create DefaultCharIsUnsigned property.
 TreatWChar_tAsBuiltInType (configuration, fallback=None)
 Create TreatWChar_tAsBuiltInType property.
 ForceConformanceInForLoopScope (configuration, fallback=None)
 Create ForceConformanceInForLoopScope property.
 RuntimeTypeInfo (configuration, fallback=None)
 Create RuntimeTypeInfo property.
 OpenMP (configuration, fallback=None)
 Create OpenMP property.
 UsePrecompiledHeader (configuration, fallback=None)
 Create UsePrecompiledHeader property.
 PrecompiledHeaderThrough (configuration, fallback=None)
 Create AdditionalOptions property.
 PrecompiledHeaderFile (configuration, fallback=None)
 Create AdditionalOptions property.
 ExpandAttributedSource (configuration, fallback=None)
 Create ExpandAttributedSource property.
 AssemblerOutput (configuration, fallback=None)
 Create AssemblerOutput property.
 AssemblerListingLocation (configuration, fallback=None)
 Create AssemblerListingLocation property.
 ObjectFile (configuration, fallback=None)
 Create ObjectFile property.
 ProgramDataBaseFileName (configuration, fallback=None)
 Create ProgramDataBaseFileName property.
 GenerateXMLDocumentationFiles (configuration, fallback=None)
 Create GenerateXMLDocumentationFiles property.
 XMLDocumentationFileName (configuration, fallback=None)
 Create XMLDocumentationFileName property.
 BrowseInformation (configuration, fallback=None)
 Create BrowseInformation property.
 BrowseInformationFile (configuration, fallback=None)
 Create BrowseInformationFile property.
 WarningLevel (configuration, fallback=None)
 Create WarningLevel property.
 WarnAsError (configuration, fallback=None)
 Create WarnAsError property.
 SuppressStartupBanner (configuration, fallback=None, prefix=None)
 Create SuppressStartupBanner property.
 Detect64BitPortabilityProblems (configuration, fallback=None)
 Create Detect64BitPortabilityProblems property.
 DebugInformationFormat (configuration, fallback=None)
 Create DebugInformationFormat property.
 CallingConvention (configuration, fallback=None)
 Create CallingConvention property.
 CompileAs (configuration, fallback=None)
 Create CompileAs property.
 DisableSpecificWarnings (configuration, fallback=None)
 Create DisableSpecificWarnings property.
 ForcedIncludeFiles (configuration, fallback=None)
 Create ForcedIncludeFiles property.
 ForcedUsingFiles (configuration, fallback=None)
 Create ForcedUsingFiles property.
 ShowIncludes (configuration, fallback=None)
 Create ShowIncludes property.
 UndefinePreprocessorDefinitions (configuration, fallback=None)
 Create UndefinePreprocessorDefinitions property.
 UndefineAllPreprocessorDefinitions (configuration, fallback=None)
 Create UndefineAllPreprocessorDefinitions property.
 UseFullPaths (configuration, fallback=None)
 Create UseFullPaths property.
 OmitDefaultLibName (configuration, fallback=None)
 Create OmitDefaultLibName property.
 ErrorReporting (configuration, fallback=None)
 Create ErrorReporting property.
 Description (configuration, fallback=None, prefix=None)
 Create Description property.
 CommandLine (configuration, fallback=None, prefix=None)
 Create CommandLine property.
 AdditionalDependencies (configuration, fallback=None, prefix=None)
 Create AdditionalDependencies property.
 Outputs (configuration, fallback=None)
 Create Outputs property.
 RegisterOutput (configuration, fallback=None)
 Create RegisterOutput property.
 PerUserRedirection (configuration, fallback=None)
 Create PerUserRedirection property.
 IgnoreImportLibrary (configuration, fallback=None)
 Create IgnoreImportLibrary property.
 LinkLibraryDependencies (configuration, fallback=None)
 Create LinkLibraryDependencies property.
 UseLibraryDependencyInputs (configuration, fallback=None)
 Create UseLibraryDependencyInputs property.
 ShowProgress (configuration, fallback=None)
 Create ShowProgress property.
 OutputFile (configuration, fallback=None)
 Create OutputFile property.
 Version (configuration, fallback=None)
 Create Version property.
 LinkIncremental (configuration, fallback=None)
 Create LinkIncremental property.
 GenerateManifest (configuration, fallback=None)
 Create GenerateManifest property.
 ManifestFile (configuration, fallback=None)
 Create ManifestFile property.
 AdditionalManifestDependencies (configuration, fallback=None)
 Create AdditionalManifestDependencies property.
 EnableUAC (configuration, fallback=None)
 Create EnableUAC property.
 UACExecutionLevel (configuration, fallback=None)
 Create UACExecutionLevel property.
 UACUIAccess (configuration, fallback=None)
 Create UACUIAccess property.
 IgnoreAllDefaultLibraries (configuration, fallback=None)
 Create IgnoreAllDefaultLibraries property.
 IgnoreDefaultLibraryNames (configuration, fallback=None)
 Create IgnoreDefaultLibraryNames property.
 ModuleDefinitionFile (configuration, fallback=None)
 Create ModuleDefinitionFile property.
 AddModuleNamesToAssembly (configuration, fallback=None)
 Create AddModuleNamesToAssembly property.
 EmbedManagedResourceFile (configuration, fallback=None)
 Create EmbedManagedResourceFile property.
 ForceSymbolReferences (configuration, fallback=None)
 Create ForceSymbolReferences property.
 DelayLoadDLLs (configuration, fallback=None)
 Create DelayLoadDLLs property.
 AssemblyLinkResource (configuration, fallback=None)
 Create AssemblyLinkResource property.
 MidlCommandFile (configuration, fallback=None)
 Create MidlCommandFile property.
 IgnoreEmbeddedIDL (configuration, fallback=None)
 Create IgnoreEmbeddedIDL property.
 MergedIDLBaseFileName (configuration, fallback=None)
 Create MergedIDLBaseFileName property.
 TypeLibraryFile (configuration, fallback=None)
 Create TypeLibraryFile property.
 TypeLibraryResourceID (configuration, fallback=None)
 Create TypeLibraryResourceID property.
 GenerateDebugInformation (configuration, fallback=None)
 Create GenerateDebugInformation property.
 AssemblyDebug (configuration, fallback=None)
 Create AssemblyDebug property.
 ProgramDatabaseFile (configuration, fallback=None)
 Create ProgramDatabaseFile property.
 StripPrivateSymbols (configuration, fallback=None)
 Create StripPrivateSymbols property.
 GenerateMapFile (configuration, fallback=None)
 Create GenerateMapFile property.
 MapFileName (configuration, fallback=None)
 Create MapFileName property.
 MapExports (configuration, fallback=None)
 Create MapExports property.
 MapLines (configuration, fallback=None)
 Create MapLines property.
 SubSystem (configuration, fallback=None)
 Create SubSystem property.
 HeapReserveSize (configuration, fallback=None)
 Create SubSystem property.
 HeapCommitSize (configuration, fallback=None)
 Create SubSystem property.
 StackReserveSize (configuration, fallback=None)
 Create SubSystem property.
 StackCommitSize (configuration, fallback=None)
 Create SubSystem property.
 LargeAddressAware (configuration, fallback=None)
 Create LargeAddressAware property.
 TerminalServerAware (configuration, fallback=None)
 Create TerminalServerAware property.
 SwapRunFromCD (configuration, fallback=None)
 Create SwapRunFromCD property.
 SwapRunFromNet (configuration, fallback=None)
 Create SwapRunFromNet property.
 Driver (configuration, fallback=None)
 Create Driver property.
 OptimizeReferences (configuration, fallback=None)
 Create OptimizeReferences property.
 EnableCOMDATFolding (configuration, fallback=None)
 Create EnableCOMDATFolding property.
 OptimizeForWindows98 (configuration, fallback=None)
 Create OptimizeForWindows98 property.
 FunctionOrder (configuration, fallback=None)
 Create FunctionOrder property.
 LinkTimeCodeGeneration (configuration, fallback=None)
 Create LinkTimeCodeGeneration property.
 ProfileGuidedDatabase (configuration, fallback=None)
 Create ProfileGuidedDatabase property.
 EntryPointSymbol (configuration, fallback=None)
 Create EntryPointSymbol property.
 ResourceOnlyDLL (configuration, fallback=None)
 Create ResourceOnlyDLL property.
 SetChecksum (configuration, fallback=None)
 Create SetChecksum property.
 BaseAddress (configuration, fallback=None)
 Create BaseAddress property.
 RandomizedBaseAddress (configuration, fallback=None)
 Create RandomizedBaseAddress property.
 FixedBaseAddress (configuration, fallback=None)
 Create FixedBaseAddress property.
 DataExecutionPrevention (configuration, fallback=None)
 Create DataExecutionPrevention property.
 TurnOffAssemblyGeneration (configuration, fallback=None)
 Create TurnOffAssemblyGeneration property.
 SupportUnloadOfDelayLoadedDLL (configuration, fallback=None)
 Create SupportUnloadOfDelayLoadedDLL property.
 ImportLibrary (configuration, fallback=None)
 Create ImportLibrary property.
 MergeSections (configuration, fallback=None)
 Create MergeSections property.
 TargetMachine (configuration, fallback=None)
 Create TargetMachine property.
 KeyFile (configuration, fallback=None)
 Create KeyFile property.
 KeyContainer (configuration, fallback=None)
 Create KeyContainer property.
 DelaySign (configuration, fallback=None)
 Create DelaySign property.
 AllowIsolation (configuration, fallback=None)
 Create AllowIsolation property.
 Profile (configuration, fallback=None)
 Create Profile property.
 CLRThreadAttribute (configuration, fallback=None)
 Create CLRThreadAttribute property.
 CLRImageType (configuration, fallback=None)
 Create CLRImageType property.
 CLRUnmanagedCodeCheck (configuration, fallback=None)
 Create CLRUnmanagedCodeCheck property.
 ExportNamedFunctions (configuration, fallback=None)
 Create ExportNamedFunctions property.
 do_filter_tree (xml_entry, filter_name, tree, groups)
 Recursively create a Filter/File tree.
 generate (solution)
 Create a solution and project(s) file for Visual Studio.

Variables

tuple SUPPORTED_IDES
 List of IDETypes the visual_studio module supports.
 _SLNFILE_MATCH
 Regex for matching files with *.sln.
dict _VS_VERSION_YEARS
 Dict of version year strings to integers 2012-2022.
dict _VS_OLD_VERSION_YEARS
 Dict of version year strings 2003-2012 to integers.
dict _VS_SDK_ENV_VARIABLE
 Dict of environment variables for game consoles.
tuple _VS_SLOW_MSBUILD
 Tuple of Visual Studio targets that build slowly with msbuild.
dict _VS_PLATFORM_HACK
 Dict of android targets to remap from nVidia to Microsoft tool chains.

Detailed Description

Project file generator for Microsoft Visual Studio 2003-2008.

This module contains classes needed to generate project files intended for use by Microsoft's Visual Studio 2003, 2005 and 2008.

Function Documentation

◆ AdditionalDependencies()

makeprojects.visual_studio.AdditionalDependencies ( configuration,
fallback = None,
prefix = None )

Create AdditionalDependencies property.

List of files this build object depends on. If custom build, it's a list of input files for the build script. If it's a linker, it's a list of library files to link into the final output.

Can be overridden with configuration attributes:

  • vs_AdditionalDependencies for Linkers
  • vs_CustomAdditionalDependencies for CustomBuild
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
prefixPrefix string for override
Returns
validators.VSStringListProperty object.

◆ AdditionalIncludeDirectories()

makeprojects.visual_studio.AdditionalIncludeDirectories ( configuration,
fallback = None )

Create AdditionalIncludeDirectories property.

List of include folders for the C compiler

Can be overridden with configuration attribute vs_AdditionalIncludeDirectories for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ AdditionalManifestDependencies()

makeprojects.visual_studio.AdditionalManifestDependencies ( configuration,
fallback = None )

Create AdditionalManifestDependencies property.

List of manifests this one is dependent on

Can be overridden with configuration attribute vs_AdditionalManifestDependencies for the custom builder.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSStringListProperty object.

◆ AdditionalOptions()

makeprojects.visual_studio.AdditionalOptions ( configuration,
fallback = None,
prefix = None )

Create AdditionalOptions property.

List of custom compiler options as a single string. The default is an empty string. Will not generate this attribute if the string is empty.

Can be overridden with configuration attributes:

  • vs_AdditionalOptions for the C compiler.
  • vs_LinkerAdditionalOptions for the exe/lib linker.
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
prefixPrefix string for override
Returns
validators.VSStringProperty object.

◆ AdditionalUsingDirectories()

makeprojects.visual_studio.AdditionalUsingDirectories ( configuration,
fallback = None )

Create AdditionalUsingDirectories property.

List of include folders for the # using operation.

Can be overridden with configuration attribute vs_AdditionalUsingDirectories for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ AddModuleNamesToAssembly()

makeprojects.visual_studio.AddModuleNamesToAssembly ( configuration,
fallback = None )

Create AddModuleNamesToAssembly property.

Add these modules to C# assembly

Can be overridden with configuration attribute vs_AddModuleNamesToAssembly for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ AllowIsolation()

makeprojects.visual_studio.AllowIsolation ( configuration,
fallback = None )

Create AllowIsolation property.

Specifies manifest file lookup behavior for side-by-side assemblies.

Compiler switch /ALLOWISOLATION:NO

Note
Only available on Visual Studio 2005 or higher
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ AssemblerListingLocation()

makeprojects.visual_studio.AssemblerListingLocation ( configuration,
fallback = None )

Create AssemblerListingLocation property.

Output location for .asm file

Can be overridden with configuration attribute vs_AssemblerListingLocation for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ AssemblerOutput()

makeprojects.visual_studio.AssemblerOutput ( configuration,
fallback = None )

Create AssemblerOutput property.

Set the format of the assembly output

Compiler switches /FA, /FAcs, /FAc, /FAs

Can be overridden with configuration attribute vs_AssemblerOutput for the C compiler.

  • "No" / "No Listing"
  • "/FA" / "Assembly" / "Asm" / "Assembly-Only"
  • "/FAcs" / "Assembly, Machine Code and Source"
  • "/FAc" / "Assembly With Machine Code"
  • "/FAs" / "Assembly With Source"
  • 0 through 4
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ AssemblyDebug()

makeprojects.visual_studio.AssemblyDebug ( configuration,
fallback = None )

Create AssemblyDebug property.

Add debugging information in assembly

Compiler switches /ASSEMBLYDEBUG, /ASSEMBLYDEBUG:DISABLE

Can be overridden with configuration attribute vs_AssemblyDebug for the linker.

  • "No" / "None"
  • "/ASSEMBLYDEBUG" / "Runtime Tracking"
  • "/ASSEMBLYDEBUG:DISABLE" / "No Runtime Tracking"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ AssemblyLinkResource()

makeprojects.visual_studio.AssemblyLinkResource ( configuration,
fallback = None )

Create AssemblyLinkResource property.

Link in these assemblies

Can be overridden with configuration attribute vs_AssemblyLinkResource for the linker.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSStringListProperty object.

◆ ATLMinimizesCRunTimeLibraryUsage()

makeprojects.visual_studio.ATLMinimizesCRunTimeLibraryUsage ( configuration,
fallback = None )

Create ATLMinimizesCRunTimeLibraryUsage property.

Tells ATL to link to the C runtime libraries statically to minimize dependencies; requires that Use of ATL to be set.

Can be overridden with configuration attribute vs_ATLMinimizesCRunTimeLibraryUsage for the C compiler.

Note
Not available on Visual Studio 2008 or later and only available on Windows platforms
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ BaseAddress()

makeprojects.visual_studio.BaseAddress ( configuration,
fallback = None )

Create BaseAddress property.

Base address for execution.

Can be overridden with configuration attribute vs_BaseAddress for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ BasicRuntimeChecks()

makeprojects.visual_studio.BasicRuntimeChecks ( configuration,
fallback = None )

Create BasicRuntimeChecks property.

Generate runtime code to verify the stack and uninitialized variables.

Compiler switches /RTCs, /RTCu, /RTC1

Can be overridden with configuration attribute vs_BasicRuntimeChecks for the C compiler.

  • "Default"
  • "/RTCs" / "Stack" / "Stack Frames"
  • "/RTCu" / "Uninitialzed" / "Uninitialized Variables"
  • "/RTCsu" / "/RTC1" / "Both"
  • 0 through 3
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ BrowseInformation()

makeprojects.visual_studio.BrowseInformation ( configuration,
fallback = None )

Create BrowseInformation property.

What browser information to generate?

Compiler switches /FR, /Fr

Can be overridden with configuration attribute vs_BrowseInformation for the C compiler.

  • "None" / "No"
  • "/FR" / "All"
  • "/Fr" / "No Local Symbols" / "No Locals"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ BrowseInformationFile()

makeprojects.visual_studio.BrowseInformationFile ( configuration,
fallback = None )

Create BrowseInformationFile property.

Name of the browsing file.

Can be overridden with configuration attribute vs_BrowseInformationFile for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ BufferSecurityCheck()

makeprojects.visual_studio.BufferSecurityCheck ( configuration,
fallback = None )

Create BufferSecurityCheck property.

Check for buffer overruns; useful for closing hackable loopholes on internet servers; ignored for projects using managed extensions.

Compiler switch /GS

Can be overridden with configuration attribute vs_BufferSecurityCheck for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ CallingConvention()

makeprojects.visual_studio.CallingConvention ( configuration,
fallback = None )

Create CallingConvention property.

Sets the type of default calling convention to use. Usually only meaningful for X86.

Compiler switches /Gd, /Gr, /Gz

Can be overridden with configuration attribute vs_CallingConvention for the C compiler.

  • "/Gd" / "__cdecl"
  • "/Gr" / "__fastcall"
  • "/Gz" / "__stdcall"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ CharacterSet()

makeprojects.visual_studio.CharacterSet ( configuration,
fallback = None )

Create CharacterSet property.

Choose if Unicode or ASCII defaults are used during Windows compilation.

Can be overridden with configuration attribute vs_CharacterSet for the C compiler.

  • "Default"
  • "Unicode"
  • "MultiByte" / "ASCII"
  • 0 through 2
Note
Only available on Windows platforms
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ CLRImageType()

makeprojects.visual_studio.CLRImageType ( configuration,
fallback = None )

Create CLRImageType property.

CLR data image type

Compiler switches /CLRIMAGETYPE:IJW, /CLRIMAGETYPE:PURE

Can be overridden with configuration attribute vs_CLRImageType for the linker.

  • "Default"
  • "/CLRIMAGETYPE:IJW" / "IJW"
  • "/CLRIMAGETYPE:PURE" / "RelPureocatable"
  • "/CLRIMAGETYPE:SAFE" / "Safe"
  • 0 through 3
Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ CLRThreadAttribute()

makeprojects.visual_studio.CLRThreadAttribute ( configuration,
fallback = None )

Create CLRThreadAttribute property.

CLR Thread attribute

Compiler switches /CLRTHREADATTRIBUTE:MTA, /CLRTHREADATTRIBUTE:STA

Can be overridden with configuration attribute vs_CLRThreadAttribute for the linker.

  • "Default"
  • "/CLRTHREADATTRIBUTE:MTA" / "MTA"
  • "/CLRTHREADATTRIBUTE:STA" / "STA"
  • 0 through 2
Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ CLRUnmanagedCodeCheck()

makeprojects.visual_studio.CLRUnmanagedCodeCheck ( configuration,
fallback = None )

Create CLRUnmanagedCodeCheck property.

Specifies whether the linker will apply SuppressUnmanagedCodeSecurityAttribute to linker-generated PInvoke calls.

Compiler switch /CLRUNMANAGEDCODECHECK

Note
Only available on Visual Studio 2005 or higher
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ CommandLine()

makeprojects.visual_studio.CommandLine ( configuration,
fallback = None,
prefix = None )

Create CommandLine property.

Batch file contents

Can be overridden with configuration attributes:

  • vs_CommandLine for CustomBuild
  • vs_PreBuildCommandLine for PreBuild
  • vs_PostBuildCommandLine for PostBuild
  • vs_PreLinkCommandLine for PreLink
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
prefixPrefix string for override
Returns
validators.VSStringProperty object.

◆ CompileAs()

makeprojects.visual_studio.CompileAs ( configuration,
fallback = None )

Create CompileAs property.

Forces C or C++ compilation. Normally the file extension determines the choice of compiler.

Compiler switches /TC, /TP

Can be overridden with configuration attribute vs_CompileAs for the C compiler.

  • "No" / "Default"
  • "/TC" / "C"
  • "/TP" / "C++" / "CPP"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ ConfigurationType()

makeprojects.visual_studio.ConfigurationType ( configuration,
fallback = None )

Create ConfigurationType property.

Type of project generated, dll, static lib, executable.

No external overrides

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSIntegerProperty object.

◆ create_build_object()

makeprojects.visual_studio.create_build_object ( file_name,
priority = 50,
configurations = None,
verbose = False )

Create BuildVisualStudioFile build records for every desired configuration.

Parameters
file_namePathname to the *.sln to build
priorityPriority to build this object
configurationsConfiguration list to build
verboseTrue if verbose output
Returns
list of BuildVisualStudioFile classes

◆ create_clean_object()

makeprojects.visual_studio.create_clean_object ( file_name,
priority = 50,
configurations = None,
verbose = False )

Create BuildVisualStudioFile clean records for every desired configuration.

Parameters
file_namePathname to the *.sln to build
priorityPriority to clean this object
configurationsConfiguration list to clean
verboseTrue if verbose output
Returns
list of BuildVisualStudioFile classes

◆ DataExecutionPrevention()

makeprojects.visual_studio.DataExecutionPrevention ( configuration,
fallback = None )

Create DataExecutionPrevention property.

Enable Data execution protection

Compiler switches /NXCOMPAT:NO, /NXCOMPAT

Can be overridden with configuration attribute vs_DataExecutionPrevention for the linker.

  • "Default"
  • "/NXCOMPAT:NO" / "Disable"
  • "/NXCOMPAT" / "Enable"
  • 0 through 2
Note
Not available on Visual Studio 2003 or 2005
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ DebugInformationFormat()

makeprojects.visual_studio.DebugInformationFormat ( configuration,
fallback = None )

Create DebugInformationFormat property.

Sets the type of debugging information to embed in the obj file.

Compiler switches /C7, /Zd, /Zi, /ZI

Can be overridden with configuration attribute vs_DebugInformationFormat for the C compiler.

  • "Off" / "No" / "None" / "Disabled"
  • "/C7" / "C7 Compatible"
  • "/Zd" / "Line Numbers" / "Line Numbers Only"
  • "/Zi" / "Program Database"
  • "/ZI" / "Edit and Continue"
  • 0 through 4
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ DefaultCharIsUnsigned()

makeprojects.visual_studio.DefaultCharIsUnsigned ( configuration,
fallback = None )

Create DefaultCharIsUnsigned property.

Sets the default char type to unsigned.

Compiler switch /J

Can be overridden with configuration attribute vs_DefaultCharIsUnsigned for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ DelayLoadDLLs()

makeprojects.visual_studio.DelayLoadDLLs ( configuration,
fallback = None )

Create DelayLoadDLLs property.

Only load these DLLs if functions within are called.

Can be overridden with configuration attribute vs_DelayLoadDLLs for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ DelaySign()

makeprojects.visual_studio.DelaySign ( configuration,
fallback = None )

Create DelaySign property.

Indicates whether the output assembly should be delay signed.

Compiler switch /DELAYSIGN

Note
Only available on Visual Studio 2005 or higher
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ DeleteExtensionsOnClean()

makeprojects.visual_studio.DeleteExtensionsOnClean ( configuration,
fallback = None )

Create DeleteExtensionsOnClean property.

List of file extensions to remove on clean.

Can be overridden with configuration attribute vs_DeleteExtensionsOnClean for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ Description()

makeprojects.visual_studio.Description ( configuration,
fallback = None,
prefix = None )

Create Description property.

Message to print in the console

Can be overridden with configuration attributes:

  • vs_Description for CustomBuild
  • vs_PreBuildDescription for PreBuild
  • vs_PostBuildDescription for PostBuild
  • vs_PreLinkDescription for PreLink
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
prefixPrefix string for override
Returns
validators.VSStringProperty object.

◆ Detect64BitPortabilityProblems()

makeprojects.visual_studio.Detect64BitPortabilityProblems ( configuration,
fallback = None )

Create Detect64BitPortabilityProblems property.

Tells the compiler to check for 64-bit portability issues.

Compiler switch /Wp64

Can be overridden with configuration attribute vs_Detect64BitPortabilityProblems for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ DisableLanguageExtensions()

makeprojects.visual_studio.DisableLanguageExtensions ( configuration,
fallback = None )

Create DisableLanguageExtensions property.

Supresses or enables language extensions.

Compiler switch /Za

Can be overridden with configuration attribute vs_DisableLanguageExtensions for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ DisableSpecificWarnings()

makeprojects.visual_studio.DisableSpecificWarnings ( configuration,
fallback = None )

Create DisableSpecificWarnings property.

List of warnings to disable during C compilation

Can be overridden with configuration attribute vs_DisableSpecificWarnings for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ do_filter_tree()

makeprojects.visual_studio.do_filter_tree ( xml_entry,
filter_name,
tree,
groups )

Recursively create a Filter/File tree.

Dump out a recursive tree of files to reconstruct a directory hiearchy for a file list with XML Filter records.

Parameters
xml_entryRoot entry to attach records to.
filter_nameName of the current filter
treedict() containing the file list
groupsList of filter entries to match to the tree

◆ Driver()

makeprojects.visual_studio.Driver ( configuration,
fallback = None )

Create Driver property.

Set the flags if this is a device driver.

Compiler switches /DRIVER:NO, /DRIVER:UPONLY, /DRIVER:WDM

Can be overridden with configuration attribute vs_Driver for the linker.

  • "No" / "Not Set"
  • "/DRIVER:NO" / "Driver"
  • "/DRIVER:UPONLY" / "UPONLY" / "Up Only"
  • "/DRIVER:WDM" / "WDM"
  • 0 through 3
Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ EmbedManagedResourceFile()

makeprojects.visual_studio.EmbedManagedResourceFile ( configuration,
fallback = None )

Create EmbedManagedResourceFile property.

Embed the listed resource files.

Can be overridden with configuration attribute vs_EmbedManagedResourceFile for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ EnableCOMDATFolding()

makeprojects.visual_studio.EnableCOMDATFolding ( configuration,
fallback = None )

Create EnableCOMDATFolding property.

Remove redundant COMDAT symbols

Compiler switches /OPT:NOICF, /OPT:ICF

Can be overridden with configuration attribute vs_EnableCOMDATFolding for the linker.

  • "Default"
  • "/OPT:NOICF" / "Disable"
  • "/OPT:ICF" / "Enable"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ EnableEnhancedInstructionSet()

makeprojects.visual_studio.EnableEnhancedInstructionSet ( configuration,
fallback = None )

Create EnableEnhancedInstructionSet property.

Set the instruction set extensions allowed.

Compiler switches /arch:SSE, /arch:SSE2

Can be overridden with configuration attribute vs_EnableEnhancedInstructionSet for the C compiler.

  • "Default"
  • "/arch:SSE" / "SSE"
  • "/arch:SSE2" / "SSE2"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ EnableFiberSafeOptimizations()

makeprojects.visual_studio.EnableFiberSafeOptimizations ( configuration,
fallback = None )

Create EnableFiberSafeOptimizations property.

Enables memory space optimization when using fibers and thread local torage access.

Compiler switch /GT

Can be overridden with configuration attribute vs_EnableFiberSafeOptimizations for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ EnableFunctionLevelLinking()

makeprojects.visual_studio.EnableFunctionLevelLinking ( configuration,
fallback = None )

Create EnableFunctionLevelLinking property.

Enables function-level linking; required for Edit and Continue to work.

Compiler switch /Gy

Can be overridden with configuration attribute vs_EnableFunctionLevelLinking for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ EnableIntrinsicFunctions()

makeprojects.visual_studio.EnableIntrinsicFunctions ( configuration,
fallback = None )

Create EnableIntrinsicFunctions property.

Enables intrinsic functions. Using intrinsic functions generates faster, but possibly larger, code.

Compiler switch /Oi

Can be overridden with configuration attribute vs_EnableIntrinsicFunctions for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ EnableUAC()

makeprojects.visual_studio.EnableUAC ( configuration,
fallback = None )

Create EnableUAC property.

Specifies whether or not User Account Control is enabled.

Note
Not available on Visual Studio 2003 or 2005
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or VSBooleanProperty object.

◆ EntryPointSymbol()

makeprojects.visual_studio.EntryPointSymbol ( configuration,
fallback = None )

Create EntryPointSymbol property.

Code entry point symbol.

Can be overridden with configuration attribute vs_EntryPointSymbol for tshe linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ ErrorReporting()

makeprojects.visual_studio.ErrorReporting ( configuration,
fallback = None )

Create ErrorReporting property.

Is error reporting queued or immediate?

Compiler switches /errorReport:prompt, /errorReport:queue

Can be overridden with configuration attribute vs_ErrorReporting for the C compiler.

  • "Default"
  • "/errorReport:prompt" / "Immediate"
  • "/errorReport:queue" / "Queue"
  • 0 through 2
Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ ExceptionHandling()

makeprojects.visual_studio.ExceptionHandling ( configuration,
fallback = None )

Create ExceptionHandling property.

Calls destructors for automatic objects during a strack unwind caused by an exceptions being thrown.

Compiler switches /EHsc, /EHa

Can be overridden with configuration attribute vs_ExceptionHandling for the C compiler.

  • "No"
  • "/EHsc" / "Yes"
  • "/EHa" / "Yes with SEH" / "Yes with SEH Exceptions" / "SEH"
  • 0 through 2
Note
A boolean on Visual Studio 2003, an enum on 2005/2008
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty or validators.VSBooleanProperty object.

◆ ExcludedFromBuild()

makeprojects.visual_studio.ExcludedFromBuild ( fallback = None)

Create ExcludedFromBuild property.

Ignore from build if True.

Parameters
fallbackBoolean for the value
Returns
validators.VSBooleanProperty object.

◆ ExpandAttributedSource()

makeprojects.visual_studio.ExpandAttributedSource ( configuration,
fallback = None )

Create ExpandAttributedSource property.

Create listing file with expanded attributes injected into source file.

Compiler switch /Fx

Can be overridden with configuration attribute vs_ExpandAttributedSource for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ ExportNamedFunctions()

makeprojects.visual_studio.ExportNamedFunctions ( configuration,
fallback = None )

Create ExportNamedFunctions property.

Export these functions

Can be overridden with configuration attribute vs_ExportNamedFunctions for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ FavorSizeOrSpeed()

makeprojects.visual_studio.FavorSizeOrSpeed ( configuration,
fallback = None )

Create FavorSizeOrSpeed property.

Determine if optimizations should focus on saving space vs unrolling loops.

Compiler switches /Ot, /Os

Can be overridden with configuration attribute vs_FavorSizeOrSpeed for the C compiler.

Acceptable inputs are:

  • "Neither"
  • "/Ot" / "Favor Fast Code"
  • "/Os" / "Favor Small Code"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ FixedBaseAddress()

makeprojects.visual_studio.FixedBaseAddress ( configuration,
fallback = None )

Create FixedBaseAddress property.

Enable fixed address code generation

Compiler switches /FIXED:NO, /FIXED

Can be overridden with configuration attribute vs_FixedBaseAddress for the linker.

  • "Default"
  • "/FIXED:NO" / "Relocatable"
  • "/FIXED" / "Fixed"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ FloatingPointExceptions()

makeprojects.visual_studio.FloatingPointExceptions ( configuration,
fallback = None )

Create FloatingPointExceptions property.

Enable floating point exceptions when generating code.

Compiler switch /fp:except

Can be overridden with configuration attribute vs_FloatingPointExceptions for the C compiler.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ FloatingPointModel()

makeprojects.visual_studio.FloatingPointModel ( configuration,
fallback = None )

Create FloatingPointModel property.

Set the allowable precision for floating point math for speed.

Compiler switches /fp:precise, /fp:strict, /fp:fast

Can be overridden with configuration attribute vs_FloatingPointModel for the C compiler.

  • "/fp:precise" / "Precise"
  • "/fp:strict" / "Strict"
  • "/fp:fast" / "Fast"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ ForceConformanceInForLoopScope()

makeprojects.visual_studio.ForceConformanceInForLoopScope ( configuration,
fallback = None )

Create ForceConformanceInForLoopScope property.

Forces the compiler to conform to the local scope in a for loop.

Compiler switch /Zc:forScope

Can be overridden with configuration attribute vs_ForceConformanceInForLoopScope for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ ForcedIncludeFiles()

makeprojects.visual_studio.ForcedIncludeFiles ( configuration,
fallback = None )

Create ForcedIncludeFiles property.

List of header files to force including before compilation.

Can be overridden with configuration attribute vs_ForcedIncludeFiles for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ ForcedUsingFiles()

makeprojects.visual_studio.ForcedUsingFiles ( configuration,
fallback = None )

Create ForcedUsingFiles property.

List of header files to force using before compilation.

Can be overridden with configuration attribute vs_ForcedUsingFiles for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ ForceSymbolReferences()

makeprojects.visual_studio.ForceSymbolReferences ( configuration,
fallback = None )

Create ForceSymbolReferences property.

Force these symbols to be public

Can be overridden with configuration attribute vs_ForceSymbolReferences for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ FunctionOrder()

makeprojects.visual_studio.FunctionOrder ( configuration,
fallback = None )

Create FunctionOrder property.

Text file with function names to link in order.

Can be overridden with configuration attribute vs_FunctionOrder for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ generate()

makeprojects.visual_studio.generate ( solution)

Create a solution and project(s) file for Visual Studio.

Given a Solution object, create an appropriate Visual Studio solution and project files to allow this project to build.

Parameters
solutionSolution instance.
Returns
Zero if no error, non-zero on error.

◆ GenerateDebugInformation()

makeprojects.visual_studio.GenerateDebugInformation ( configuration,
fallback = None )

Create GenerateDebugInformation property.

Enables generation of debug information.

Compiler switch /DEBUG

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or VSBooleanProperty object.

◆ GenerateManifest()

makeprojects.visual_studio.GenerateManifest ( configuration,
fallback = None )

Create GenerateManifest property.

Specifies if the linker should always generate a manifest file.

Can be overridden with configuration attribute vs_GenerateManifest for the Linker.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ GenerateMapFile()

makeprojects.visual_studio.GenerateMapFile ( configuration,
fallback = None )

Create GenerateMapFile property.

Enables generation of map file during linking.

Compiler switch /MAP

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ GeneratePreprocessedFile()

makeprojects.visual_studio.GeneratePreprocessedFile ( configuration,
fallback = None )

Create GeneratePreprocessedFile property.

Determine if a preprocessed file is to be generated.

Compiler switches /P, /EP

Can be overridden with configuration attribute vs_GeneratePreprocessedFile for the C compiler.

Acceptable inputs are:

  • "No"
  • "/P" / "With Line Numbers"
  • "/EP" / "Without Line Numbers"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ GenerateXMLDocumentationFiles()

makeprojects.visual_studio.GenerateXMLDocumentationFiles ( configuration,
fallback = None )

Create GenerateXMLDocumentationFiles property.

Specifies that the compiler should generate XML documentation comment files.

Compiler switch /doc

Can be overridden with configuration attribute vs_GenerateXMLDocumentationFiles for the C compiler.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ GlobalOptimizations()

makeprojects.visual_studio.GlobalOptimizations ( configuration,
fallback = None )

Create GlobalOptimizations property.

Enables global optimizations incompatible with all Runtime Checks options and edit and continue. Also known as WholeProgramOptimizations on other versions of Visual Studio.

Compiler switch /Og

Can be overridden with configuration attribute vs_GlobalOptimizations for the C compiler.

Note
Only available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ HeapCommitSize()

makeprojects.visual_studio.HeapCommitSize ( configuration,
fallback = None )

Create SubSystem property.

Amount of heap to commit

Can be overridden with configuration attribute vs_HeapCommitSize for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSIntegerProperty object.

◆ HeapReserveSize()

makeprojects.visual_studio.HeapReserveSize ( configuration,
fallback = None )

Create SubSystem property.

Amount of heap to reserve

Can be overridden with configuration attribute vs_HeapReserveSize for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSIntegerProperty object.

◆ IgnoreAllDefaultLibraries()

makeprojects.visual_studio.IgnoreAllDefaultLibraries ( configuration,
fallback = None )

Create IgnoreAllDefaultLibraries property.

Ignore all default libraries during linking.

Compiler switch /NODEFAULTLIB

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ IgnoreDefaultLibraryNames()

makeprojects.visual_studio.IgnoreDefaultLibraryNames ( configuration,
fallback = None )

Create IgnoreDefaultLibraryNames property.

List of libraries to ignore

Can be overridden with configuration attribute vs_IgnoreDefaultLibraryNames for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ IgnoreEmbeddedIDL()

makeprojects.visual_studio.IgnoreEmbeddedIDL ( configuration,
fallback = None )

Create IgnoreEmbeddedIDL property.

Ignore embedded .idlsym sections of object files.

Compiler switch /IGNOREIDL

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ IgnoreImportLibrary()

makeprojects.visual_studio.IgnoreImportLibrary ( configuration,
fallback = None )

Create IgnoreImportLibrary property.

Specifies that the import library generated by this configuration should not be imported into dependent projects.

Can be overridden with configuration attribute vs_IgnoreImportLibrary for the Linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ IgnoreStandardIncludePath()

makeprojects.visual_studio.IgnoreStandardIncludePath ( configuration,
fallback = None )

Create IgnoreStandardIncludePath property.

Ignore standard include paths.

Compiler switch /X

Can be overridden with configuration attribute vs_IgnoreStandardIncludePath for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ ImportLibrary()

makeprojects.visual_studio.ImportLibrary ( configuration,
fallback = None )

Create ImportLibrary property.

Name of the import library to generate.

Can be overridden with configuration attribute vs_ImportLibrary for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ ImproveFloatingPointConsistency()

makeprojects.visual_studio.ImproveFloatingPointConsistency ( configuration,
fallback = None )

Create ImproveFloatingPointConsistency property.

Enables intrinsic functions. Using intrinsic functions generates faster, but possibly larger, code.

Compiler switch /Op

Can be overridden with configuration attribute vs_ImproveFloatingPointConsistency for the C compiler.

Note
Only available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ InlineFunctionExpansion()

makeprojects.visual_studio.InlineFunctionExpansion ( configuration,
fallback = None )

Create InlineFunctionExpansion property.

Determine how aggressive to inline code during C compilation.

Compiler switches /Ob1, /Ob2

Can be overridden with configuration attribute vs_InlineFunctionExpansion for the C compiler.

Acceptable inputs are:

  • "Disable"
  • "/Ob1" / "Only __inline"
  • "/Ob2" / "Any Suitable"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ IntermediateDirectory()

makeprojects.visual_studio.IntermediateDirectory ( configuration,
fallback = None )

Create IntermediateDirectory property.

Directory to store the intermediate outputs such as .obj and .res files

Can be overridden with configuration attribute vs_IntermediateDirectory for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ KeepComments()

makeprojects.visual_studio.KeepComments ( configuration,
fallback = None )

Create KeepComments property.

Suppresses comment strip from source code; requires that one of the Preprocessing options be set.

Compiler switch /C

Can be overridden with configuration attribute vs_KeepComments for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ KeyContainer()

makeprojects.visual_studio.KeyContainer ( configuration,
fallback = None )

Create KeyContainer property.

Name of the container of the key.

Can be overridden with configuration attribute vs_KeyContainer for the linker.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSStringProperty object.

◆ KeyFile()

makeprojects.visual_studio.KeyFile ( configuration,
fallback = None )

Create KeyFile property.

File with key for signing.

Can be overridden with configuration attribute vs_KeyFile for the linker.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSStringProperty object.

◆ LargeAddressAware()

makeprojects.visual_studio.LargeAddressAware ( configuration,
fallback = None )

Create LargeAddressAware property.

Notifies Windows the application is 32 bit clean.

Compiler switches /LARGEADDRESSAWARE:NO, /LARGEADDRESSAWARE

Can be overridden with configuration attribute vs_LargeAddressAware for the linker.

  • "Default"
  • "/LARGEADDRESSAWARE:NO" / "Disable"
  • "/LARGEADDRESSAWARE" / "Enable"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ LinkIncremental()

makeprojects.visual_studio.LinkIncremental ( configuration,
fallback = None )

Create LinkIncremental property.

Enable incremental linking.

Compiler switches /INCREMENTAL:NO, /INCREMENTAL

Can be overridden with configuration attribute vs_LinkIncremental for the linker.

  • "Default" / "No" / "None"
  • "/INCREMENTAL:NO" / "No"
  • "/INCREMENTAL" / "Yes"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ LinkLibraryDependencies()

makeprojects.visual_studio.LinkLibraryDependencies ( configuration,
fallback = None )

Create LinkLibraryDependencies property.

Specifies whether or not library outputs from project dependencies are automatically linked in.

Can be overridden with configuration attribute vs_LinkLibraryDependencies for the Linker.

Note
Not available on Visual Studio 2003 and earlier
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ LinkTimeCodeGeneration()

makeprojects.visual_studio.LinkTimeCodeGeneration ( configuration,
fallback = None )

Create LinkTimeCodeGeneration property.

Link using link time code generation

Compiler switches /ltcg, /ltcg:pginstrument

Can be overridden with configuration attribute vs_LinkTimeCodeGeneration for the linker.

  • "Default"
  • "/ltcg" / "Enable"
  • "/ltcg:pginstrument" / "Instrument"
  • "/ltcg:pgoptimize" / "Optimize"
  • "/ltcg:pgupdate" / "Update"
  • 0 through 4
Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ ManagedExtensions()

makeprojects.visual_studio.ManagedExtensions ( configuration,
fallback = None )

Create ManagedExtensions property.

Enable the level of Common Language Runtime support

Compiler switches /clr, /clr:pure, /clr:safe, /clr:oldSyntax

Can be overridden with configuration attribute vs_ManagedExtensions for the C compiler.

* "No", "Default"
  • "/clr" / "CLR" / "Yes"
  • "/clr:pure" / "Pure MISL" / "MISL" / "Pure"
  • "/clr:safe" / "Safe MISL" / "Safe"
  • "/clr:oldSyntax" / "Old MISL" / "Old"
  • 0 through 4
Note
A boolean on Visual Studio 2003, an enum on 2005/2008
Only available on Windows platforms
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty or validators.VSBooleanProperty object.

◆ ManifestFile()

makeprojects.visual_studio.ManifestFile ( configuration,
fallback = None )

Create ManifestFile property.

Name of the manifest file.

Can be overridden with configuration attribute vs_ManifestFile for the linker.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSStringProperty object.

◆ MapExports()

makeprojects.visual_studio.MapExports ( configuration,
fallback = None )

Create MapExports property.

Includes exported functions in map file information.

Compiler switch /MAPINFO:EXPORTS

Can be overridden with configuration attribute vs_MapExports for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ MapFileName()

makeprojects.visual_studio.MapFileName ( configuration,
fallback = None )

Create MapFileName property.

Name of the symbol map file

Can be overridden with configuration attribute vs_MapFileName for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ MapLines()

makeprojects.visual_studio.MapLines ( configuration,
fallback = None )

Create MapLines property.

Includes source code line number information in map file.

Compiler switch /MAPINFO:LINES

Can be overridden with configuration attribute vs_MapLines for the linker.

Note
Only available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ match()

makeprojects.visual_studio.match ( filename)

Check if the filename is a type that this module supports.

Match if the filename ends with .sln.

Parameters
filenameFilename to match
Returns
False if not a match, True if supported

◆ MergedIDLBaseFileName()

makeprojects.visual_studio.MergedIDLBaseFileName ( configuration,
fallback = None )

Create MergedIDLBaseFileName property.

Filename to contain the merged IDL file

Can be overridden with configuration attribute vs_MergedIDLBaseFileName for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ MergeSections()

makeprojects.visual_studio.MergeSections ( configuration,
fallback = None )

Create MergeSections property.

Sections to merge on link.

Can be overridden with configuration attribute vs_MergeSections for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ MidlCommandFile()

makeprojects.visual_studio.MidlCommandFile ( configuration,
fallback = None )

Create MidlCommandFile property.

Midl command file to execute.

Can be overridden with configuration attribute vs_MidlCommandFile for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ MinimalRebuild()

makeprojects.visual_studio.MinimalRebuild ( configuration,
fallback = None )

Create MinimalRebuild property.

Detect changes to C++ class definitions and recompile only affected source files.

Compiler switch /Gm

Can be overridden with configuration attribute vs_MinimalRebuild for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ ModuleDefinitionFile()

makeprojects.visual_studio.ModuleDefinitionFile ( configuration,
fallback = None )

Create ModuleDefinitionFile property.

Name of the module definition file

Can be overridden with configuration attribute vs_ModuleDefinitionFile for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ Name()

makeprojects.visual_studio.Name ( fallback)

Create Name property.

Simple string with the Name keyword

No external overrides

Parameters
fallbackString for the value
Returns
validators.VSStringProperty object.

◆ ObjectFile()

makeprojects.visual_studio.ObjectFile ( configuration,
fallback = None )

Create ObjectFile property.

Output location for .obj file

Can be overridden with configuration attribute vs_ObjectFile for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ OmitDefaultLibName()

makeprojects.visual_studio.OmitDefaultLibName ( configuration,
fallback = None )

Create OmitDefaultLibName property.

Do not include default library names in .obj files.

Compiler switch /Zl

Can be overridden with configuration attribute vs_OmitDefaultLibName for the C compiler.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ OmitFramePointers()

makeprojects.visual_studio.OmitFramePointers ( configuration,
fallback = None )

Create OmitFramePointers property.

Suppress frame pointers.

Compiler switch /Oy

Can be overridden with configuration attribute vs_OmitFramePointers for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ OpenMP()

makeprojects.visual_studio.OpenMP ( configuration,
fallback = None )

Create OpenMP property.

Enable OpenMP language extensions.

Compiler switch /openmp

Can be overridden with configuration attribute vs_OpenMP for the C compiler.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ Optimization()

makeprojects.visual_studio.Optimization ( configuration,
fallback = None )

Create Optimization property.

Set the level of code optimization for the C compiler.

Compiler switches /Od, /O1, /O2, /Ox

Can be overridden with configuration attribute vs_Optimization for the C compiler.

Acceptable inputs are:

  • "/Od" / "-Od" / "Disabled"
  • "/O1" / "-O1" / "Minimize Size"
  • "/O2" / "-O2" / "Maximize Speed"
  • "/Ox" / "-Ox" / "Full Optimization" / "x"
  • "Custom" (This disables emitting a command switch)
  • 0 through 4
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ OptimizeForProcessor()

makeprojects.visual_studio.OptimizeForProcessor ( configuration,
fallback = None )

Create OptimizeForProcessor property.

Determine if optimizations should focus on specific Pentium processors.

Compiler switches /G5, /G6, /G7

Can be overridden with configuration attribute vs_OptimizeForProcessor for the C compiler.

Acceptable inputs are:

  • "Blended"
  • "/G5" / "Pentium"
  • "/G6" / "Pentium Pro" / "Pentium II" / "Pentium III"
  • "/G7" / "Pentium IV" / "Pentium 4"
  • 0 through 3
Note
Only available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ OptimizeForWindows98()

makeprojects.visual_studio.OptimizeForWindows98 ( configuration,
fallback = None )

Create OptimizeForWindows98 property.

Align code on 4K boundaries for Windows 98

Compiler switches /OPT:NOWIN98, /OPT:WIN98

Can be overridden with configuration attribute vs_OptimizeForWindows98 for the linker.

  • "Default"
  • "/OPT:NOWIN98" / "Disable"
  • "/OPT:WIN98" / "Enable"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ OptimizeForWindowsApplication()

makeprojects.visual_studio.OptimizeForWindowsApplication ( configuration,
fallback = None )

Create OptimizeForWindowsApplication property.

Specify whether to optimize code in favor of Windows.EXE execution.

Compiler switch /GA

Can be overridden with configuration attribute vs_OptimizeForWindowsApplication for the C compiler.

Note
Only available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ OptimizeReferences()

makeprojects.visual_studio.OptimizeReferences ( configuration,
fallback = None )

Create OptimizeReferences property.

Remove unreferenced code

Compiler switches /OPT:NOREF, /OPT:REF

Can be overridden with configuration attribute vs_OptimizeReferences for the linker.

  • "Default"
  • "/OPT:NOREF" / "Disable"
  • "/OPT:REF" / "Enable"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ OutputDirectory()

makeprojects.visual_studio.OutputDirectory ( configuration,
fallback = None )

Create OutputDirectory property.

Directory to store the final exe/lib file output. Will remap to OutDir

Can be overridden with configuration attribute vs_OutputDirectory for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ OutputFile()

makeprojects.visual_studio.OutputFile ( configuration,
fallback = None )

Create OutputFile property.

Name of the output file

Can be overridden with configuration attribute vs_OutputFile for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ Outputs()

makeprojects.visual_studio.Outputs ( configuration,
fallback = None )

Create Outputs property.

List of files this custom build command generates

Can be overridden with configuration attribute vs_Outputs for the custom builder.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ parse_sln_file()

makeprojects.visual_studio.parse_sln_file ( full_pathname)

Find build targets in .sln file.

Given a .sln file for Visual Studio 2003 through 2022, locate and extract all of the build targets available and return the list.

It will also determine which version of Visual Studio this solution file requires.

Parameters
full_pathnamePathname to the .sln file
Returns
tuple(list of configuration strings, integer Visual Studio version year)

◆ PerUserRedirection()

makeprojects.visual_studio.PerUserRedirection ( configuration,
fallback = None )

Create PerUserRedirection property.

When Register Output is enabled, Per-user redirection forces registry writes to HKEY_CLASSES_ROOT to be redirected to HKEY_CURRENT_USER

Can be overridden with configuration attribute vs_PerUserRedirection for the Linker.

Note
Not available on Visual Studio 2005 and earlier
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ PrecompiledHeaderFile()

makeprojects.visual_studio.PrecompiledHeaderFile ( configuration,
fallback = None )

Create AdditionalOptions property.

Binary header file for precompilation

Can be overridden with configuration attribute vs_PrecompiledHeaderFile for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ PrecompiledHeaderThrough()

makeprojects.visual_studio.PrecompiledHeaderThrough ( configuration,
fallback = None )

Create AdditionalOptions property.

Text header file for precompilation

Can be overridden with configuration attribute vs_PrecompiledHeaderThrough for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ PreprocessorDefinitions()

makeprojects.visual_studio.PreprocessorDefinitions ( configuration,
fallback = None )

Create PreprocessorDefinitions property.

List of defines to pass to the C compiler

Can be overridden with configuration attribute vs_PreprocessorDefinitions for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ Profile()

makeprojects.visual_studio.Profile ( configuration,
fallback = None )

Create Profile property.

Produce an output file that can be used with the Enterprise Developer performance profiler.

Compiler switch /PROFILE

Note
Only available on Visual Studio 2005 or higher
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ ProfileGuidedDatabase()

makeprojects.visual_studio.ProfileGuidedDatabase ( configuration,
fallback = None )

Create ProfileGuidedDatabase property.

Database file for profile based optimizations.

Can be overridden with configuration attribute vs_ProfileGuidedDatabase for the linker.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSStringProperty object.

◆ ProgramDatabaseFile()

makeprojects.visual_studio.ProgramDatabaseFile ( configuration,
fallback = None )

Create ProgramDatabaseFile property.

Name of the program database file

Can be overridden with configuration attribute vs_ProgramDatabaseFile for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ ProgramDataBaseFileName()

makeprojects.visual_studio.ProgramDataBaseFileName ( configuration,
fallback = None )

Create ProgramDataBaseFileName property.

Output location of shared .pdb file

Can be overridden with configuration attribute vs_ProgramDataBaseFileName for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ RandomizedBaseAddress()

makeprojects.visual_studio.RandomizedBaseAddress ( configuration,
fallback = None )

Create RandomizedBaseAddress property.

Enable base address randomization

Compiler switches /DYNAMICBASE:NO, /DYNAMICBASE

Can be overridden with configuration attribute vs_RandomizedBaseAddress for the linker.

  • "Default"
  • "/DYNAMICBASE:NO" / "Disable"
  • "/DYNAMICBASE" / "Enable"
  • 0 through 2
Note
Not available on Visual Studio 2003 or 2005
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ ReferencesPath()

makeprojects.visual_studio.ReferencesPath ( configuration,
fallback = None )

Create ReferencesPath property.

List of folders for file references.

Can be overridden with configuration attribute vs_ReferencesPath for the C compiler.

Note
Only available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSStringListProperty object.

◆ RegisterOutput()

makeprojects.visual_studio.RegisterOutput ( configuration,
fallback = None )

Create RegisterOutput property.

Specifies whether to register the primary output of this build to Windows.

Can be overridden with configuration attribute vs_RegisterOutput for the Linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ ResourceOnlyDLL()

makeprojects.visual_studio.ResourceOnlyDLL ( configuration,
fallback = None )

Create ResourceOnlyDLL property.

Create DLL with no entry point; incompatible with setting the Entry Point option.

Compiler switch /NOENTRY

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ RuntimeLibrary()

makeprojects.visual_studio.RuntimeLibrary ( configuration,
fallback = None )

Create RuntimeLibrary property.

Select runtime standard library to link with this code module.

Compiler switches /MT, /MTd, /MD, /MDd, /ML, /MLd

Can be overridden with configuration attribute vs_RuntimeLibrary for the C compiler.

  • "/MT" / "Multi-Threaded"
  • "/MTd" / "Multi-Threaded Debug"
  • "/MD" / "Multi-Threaded DLL"
  • "/MDd" / "Multi-Threaded DLL Debug"
  • "/ML" / "Single-Threaded"
  • "/MLd" / "Single-Threaded Debug"
  • 0 through 5
Note
The Single Threaded libraries are only available on Visual Studio 2003. If 2005 or 2008 is generated, the Multi-Threaded version is substituted.
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ RuntimeTypeInfo()

makeprojects.visual_studio.RuntimeTypeInfo ( configuration,
fallback = None )

Create RuntimeTypeInfo property.

Adds code for checking C++ object types at run time (runtime type information)

Compiler switches /GR and /GR-

Can be overridden with configuration attribute vs_RuntimeTypeInfo for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ SetChecksum()

makeprojects.visual_studio.SetChecksum ( configuration,
fallback = None )

Create SetChecksum property.

Enables setting the checksum in the header of a .exe.

Compiler switch /RELEASE

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ ShowIncludes()

makeprojects.visual_studio.ShowIncludes ( configuration,
fallback = None )

Create ShowIncludes property.

Generates a list of include files with compiler output.

Compiler switch /showIncludes

Can be overridden with configuration attribute vs_ShowIncludes for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ ShowProgress()

makeprojects.visual_studio.ShowProgress ( configuration,
fallback = None )

Create ShowProgress property.

Show progress in linking?

Compiler switches /VERBOSE, /VERBOSE:LIB

Can be overridden with configuration attribute vs_ShowProgress for the linker.

  • "Default" / "No" / "None"
  • "/VERBOSE" / "All"
  • "/VERBOSE:LIB" / "Lib"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ SmallerTypeCheck()

makeprojects.visual_studio.SmallerTypeCheck ( configuration,
fallback = None )

Create SmallerTypeCheck property.

Enable checking for conversion to smaller types, incompatible with any optimization type other than debug.

Compiler switch /RTCc

Can be overridden with configuration attribute vs_SmallerTypeCheck for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ StackCommitSize()

makeprojects.visual_studio.StackCommitSize ( configuration,
fallback = None )

Create SubSystem property.

Amount of stack to commit

Can be overridden with configuration attribute vs_StackCommitSize for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSIntegerProperty object.

◆ StackReserveSize()

makeprojects.visual_studio.StackReserveSize ( configuration,
fallback = None )

Create SubSystem property.

Amount of stack to reserve

Can be overridden with configuration attribute vs_StackReserveSize for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSIntegerProperty object.

◆ StringPooling()

makeprojects.visual_studio.StringPooling ( configuration,
fallback = None )

Create StringPooling property.

Enable read-only string pooling for generating smaller compiled code.

Compiler switch /GF

Can be overridden with configuration attribute vs_StringPooling for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ StripPrivateSymbols()

makeprojects.visual_studio.StripPrivateSymbols ( configuration,
fallback = None )

Create StripPrivateSymbols property.

Do not put symbols in the named file

Can be overridden with configuration attribute vs_StripPrivateSymbols for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ StructMemberAlignment()

makeprojects.visual_studio.StructMemberAlignment ( configuration,
fallback = None )

Create StructMemberAlignment property.

Set the default structure byte alignment.

Compiler switches /Zp1, /Zp2, /Zp4, /Zp8, /Zp16

Can be overridden with configuration attribute vs_StructMemberAlignment for the C compiler.

  • "Default"
  • "/Zp1" / "1" / "1 Byte"
  • "/Zp2" / "2" / "2 Bytes"
  • "/Zp4" / "4" / "4 Bytes"
  • "/Zp8" / "8" / "8 Bytes"
  • "/Zp16" / "16" / "16 Bytes"
  • 0 through 5
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ SubSystem()

makeprojects.visual_studio.SubSystem ( configuration,
fallback = None )

Create SubSystem property.

Subsystem to link to.

Compiler switches /SUBSYSTEM:CONSOLE, /SUBSYSTEM:WINDOWS

Can be overridden with configuration attribute vs_AssemblyDebug for the linker.

  • "No" / "None"
  • "/SUBSYSTEM:CONSOLE" / "Console"
  • "/SUBSYSTEM:WINDOWS" / "Windows"
  • "/SUBSYSTEM:NATIVE" / "Native" 2005-2008
  • "/SUBSYSTEM:EFI_APPLICATION" / "EFI Application" 2005-2008
  • "/SUBSYSTEM:EFI_BOOT_SERVICE_DRIVER" / "EFI Boot Service Driver" 2005-2008
  • "/SUBSYSTEM:EFI_ROM" / "EFI ROM" 2005-2008
  • "/SUBSYSTEM:EFI_RUNTIME_DRIVER" / "EFI Runtime" 2005-2008
  • "/SUBSYSTEM:POSIX" / "Posix" 2005
  • "/SUBSYSTEM:WINDOWSCE" / "WindowsCE" 2005-2008
  • 0 through 2 2003, 10 - 2005, 9 - 2008
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ SupportUnloadOfDelayLoadedDLL()

makeprojects.visual_studio.SupportUnloadOfDelayLoadedDLL ( configuration,
fallback = None )

Create SupportUnloadOfDelayLoadedDLL property.

Specifies allowing explicit unloading of the delayed load DLLs.

Compiler switch /DELAY:UNLOAD

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ SuppressStartupBanner()

makeprojects.visual_studio.SuppressStartupBanner ( configuration,
fallback = None,
prefix = None )

Create SuppressStartupBanner property.

Suppress the display of the startup banner and information messages.

Compiler switch /nologo

Can be overridden with configuration attributes:

  • vs_SuppressStartupBanner for the C compiler.
  • vs_LinkerSuppressStartupBanner for the exe/lib linker.
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
prefixPrefix string for override
Returns
validators.VSBooleanProperty object.

◆ SwapRunFromCD()

makeprojects.visual_studio.SwapRunFromCD ( configuration,
fallback = None )

Create SwapRunFromCD property.

Run application from the swap location of the CD.

Compiler switch /SWAPRUN:CD

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ SwapRunFromNet()

makeprojects.visual_studio.SwapRunFromNet ( configuration,
fallback = None )

Create SwapRunFromNet property.

Run application from the swap location of the Net.

Compiler switch /SWAPRUN:NET

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ TargetMachine()

makeprojects.visual_studio.TargetMachine ( configuration,
fallback = None )

Create TargetMachine property.

Target machine to build data for

Compiler switches /MACHINE:X86, /MACHINE:X64

Can be overridden with configuration attribute vs_TargetMachine for the linker.

  • "Default"
  • "/MACHINE:X86" / "Disable"
  • "/NXCOMPAT" / "Enable"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ TerminalServerAware()

makeprojects.visual_studio.TerminalServerAware ( configuration,
fallback = None )

Create TerminalServerAware property.

Notify Windows that the application is aware of the Terminal Server.

Compiler switches /TSAWARE:NO, /TSAWARE

Can be overridden with configuration attribute vs_TerminalServerAware for the linker.

  • "Default"
  • "/TSAWARE:NO" / "Disable"
  • "/TSAWARE" / "Enable"
  • 0 through 2
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ test()

makeprojects.visual_studio.test ( ide,
platform_type )

Filter for supported platforms.

Test for classic xbox that can be built with Visual Studio 2003. Windows on all versions.

Game consoles, are a long list...

Parameters
ideenums.IDETypes
platform_typeenums.PlatformTypes
Returns
True if supported, False if not

◆ TreatWChar_tAsBuiltInType()

makeprojects.visual_studio.TreatWChar_tAsBuiltInType ( configuration,
fallback = None )

Create TreatWChar_tAsBuiltInType property.

Treats wchar_t as a built-in type.

Compiler switch /Zc:wchar_t

Can be overridden with configuration attribute vs_TreatWChar_tAsBuiltInType for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ TurnOffAssemblyGeneration()

makeprojects.visual_studio.TurnOffAssemblyGeneration ( configuration,
fallback = None )

Create TurnOffAssemblyGeneration property.

Specifies that no assembly will be generated even though common language runtime information is present in the object files.

Compiler switch /NOASSEMBLY

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ TypeLibraryFile()

makeprojects.visual_studio.TypeLibraryFile ( configuration,
fallback = None )

Create TypeLibraryFile property.

Name of the type library.

Can be overridden with configuration attribute vs_TypeLibraryFile for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ TypeLibraryResourceID()

makeprojects.visual_studio.TypeLibraryResourceID ( configuration,
fallback = None )

Create TypeLibraryResourceID property.

ID number of the library resource

Can be overridden with configuration attribute vs_TypeLibraryResourceID for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSIntegerProperty object.

◆ UACExecutionLevel()

makeprojects.visual_studio.UACExecutionLevel ( configuration,
fallback = None )

Create UACExecutionLevel property.

Set the UAC level

Compiler switches /MANIFESTUAC:level=asInvoker

Can be overridden with configuration attribute vs_UACExecutionLevel for the linker.

  • "Default" / "asInvoker"
  • "highestAvailable"
  • "requireAdministrator"
  • 0 through 2
Note
Not available on Visual Studio 2003 or 2005
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ UACUIAccess()

makeprojects.visual_studio.UACUIAccess ( configuration,
fallback = None )

Create UACUIAccess property.

Specifies whether or not to bypass user interface protection levels for other windows on the desktop. Set this property to Yes only for accessability applications.

Compiler switches /MANIFESTUAC:uiAccess=true or /MANIFESTUAC:uiAccess=false

Note
Not available on Visual Studio 2003 or 2005
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ UndefineAllPreprocessorDefinitions()

makeprojects.visual_studio.UndefineAllPreprocessorDefinitions ( configuration,
fallback = None )

Create UndefineAllPreprocessorDefinitions property.

Undefine all previously defined preprocessor values.

Compiler switch /u

Can be overridden with configuration attribute vs_UndefineAllPreprocessorDefinitions for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSBooleanProperty object.

◆ UndefinePreprocessorDefinitions()

makeprojects.visual_studio.UndefinePreprocessorDefinitions ( configuration,
fallback = None )

Create UndefinePreprocessorDefinitions property.

List of defines to remove from compilation

Can be overridden with configuration attribute vs_UndefinePreprocessorDefinitions for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringListProperty object.

◆ UseFullPaths()

makeprojects.visual_studio.UseFullPaths ( configuration,
fallback = None )

Create UseFullPaths property.

Use full paths in diagnostic messages.

Compiler switch /FC

Can be overridden with configuration attribute vs_UseFullPaths for the C compiler.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ UseLibraryDependencyInputs()

makeprojects.visual_studio.UseLibraryDependencyInputs ( configuration,
fallback = None )

Create UseLibraryDependencyInputs property.

Specifies whether or not the inputs to the librarian tool are used rather than the library file itself when linking in library outputs of project dependencies.

Can be overridden with configuration attribute vs_UseLibraryDependencyInputs for the Linker.

Note
Not available on Visual Studio 2003 and earlier
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ UseOfATL()

makeprojects.visual_studio.UseOfATL ( configuration,
fallback = None )

Create UseOfATL property.

Enable the use of Advanced Template Library, static or dynamic.

Can be overridden with configuration attribute vs_UseOfATL for the C compiler.

  • "Default" / "None" / "No"
  • "Static"
  • "Dynamic" / "DLL"
  • 0 through 2
Note
Only available on Windows platforms
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ UseOfMFC()

makeprojects.visual_studio.UseOfMFC ( configuration,
fallback = None )

Create UseOfMFC property.

Enable the use of MFC, static or dynamic library.

Can be overridden with configuration attribute vs_UseOfMFC for the C compiler.

  • "Default" / "None" / "No"
  • "Static"
  • "Dynamic" / "DLL"
  • 0 through 2
Note
Only available on Windows platforms
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSEnumProperty object.

◆ UsePrecompiledHeader()

makeprojects.visual_studio.UsePrecompiledHeader ( configuration,
fallback = None )

Create UsePrecompiledHeader property.

Enable use of a precompiled header.

Compiler switches /Yc, /Yu, /YX

Can be overridden with configuration attribute vs_UsePrecompiledHeader for the C compiler.

  • "No" / "Not using"
  • "/Yc" / "Create"
  • "/YX" / "Automatic" (Only 2003)
  • "/Yu" / "Use" (2 on 2005/2008, 3 on 2003)
  • 0 through 3
Note
/YX is only available on Visual Studio 2003, on 2005/2008 it is swapped with /Yu / "Use"
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ UseUnicodeResponseFiles()

makeprojects.visual_studio.UseUnicodeResponseFiles ( configuration,
prefix = None )

Create UseUnicodeResponseFiles property.

Instructs the project system to generate UNICODE response files when spawning the librarian. Set this property to True when files in the project have UNICODE paths.

Can be overridden with configuration attributes:

  • vs_UseUnicodeResponseFiles for the C compiler.
  • vs_LinkerUseUnicodeResponseFiles for the exe/lib linker.
Note
Not available on Visual Studio 2003 and earlier. Overrides do nothing.
Parameters
configurationProject configuration to scan for overrides.
prefixPrefix string for override
Returns
validators.VSBooleanProperty object.

◆ Version()

makeprojects.visual_studio.Version ( configuration,
fallback = None )

Create Version property.

Version string for linking

Can be overridden with configuration attribute vs_Version for the linker.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSStringProperty object.

◆ WarnAsError()

makeprojects.visual_studio.WarnAsError ( configuration,
fallback = None )

Create WarnAsError property.

Enables the compiler to treat all warnings as errors.

Compiler switch /WX

Can be overridden with configuration attribute vs_WarnAsError for the C compiler.

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
VSBooleanProperty object.

◆ WarningLevel()

makeprojects.visual_studio.WarningLevel ( configuration,
fallback = None )

Create WarningLevel property.

Set the warning level.

Compiler switches /W0, /W1, /W2, /W3, /W4

Can be overridden with configuration attribute vs_WarningLevel for the C compiler.

  • "/W0" / "Off" / "No" / "None"
  • "/W1" / "Level 1"
  • "/W2" / "Level 2"
  • "/W3" / "Level 3"
  • "/W4" / "Level 4"
  • 0 through 4
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty object.

◆ WholeProgramOptimization()

makeprojects.visual_studio.WholeProgramOptimization ( configuration,
fallback = None )

Create WholeProgramOptimization property.

Enable the type of link time code generation

Can be overridden with configuration attribute vs_WholeProgramOptimization for the C compiler.

* "No", "Default"
* "Yes", "On"
  • "Instrument"
  • "Optimize"
  • "Update"
  • 0 through 4
Note
A boolean on Visual Studio 2003, an enum on 2005/2008
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
validators.VSEnumProperty or validators.VSBooleanProperty object.

◆ WholeProgramOptimization2003()

makeprojects.visual_studio.WholeProgramOptimization2003 ( configuration,
fallback = None )

Create WholeProgramOptimization property for VS 2003.

Enables cross-module optimizations by delaying code generation to link time; requires that linker option Link Time Code Generation be turned on.

Compiler switch /GL

Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSBooleanProperty object.

◆ XMLDocumentationFileName()

makeprojects.visual_studio.XMLDocumentationFileName ( configuration,
fallback = None )

Create XMLDocumentationFileName property.

Name of the XML formatted documentation file.

Can be overridden with configuration attribute vs_XMLDocumentationFileName for the C compiler.

Note
Not available on Visual Studio 2003
Parameters
configurationProject configuration to scan for overrides.
fallbackDefault value to use
Returns
None or validators.VSStringProperty object.

Variable Documentation

◆ SUPPORTED_IDES

tuple makeprojects.visual_studio.SUPPORTED_IDES
Initial value:
1= (
2 IDETypes.vs2003,
3 IDETypes.vs2005,
4 IDETypes.vs2008,
5 IDETypes.vs2010,
6 IDETypes.vs2012,
7 IDETypes.vs2013,
8 IDETypes.vs2015,
9 IDETypes.vs2017,
10 IDETypes.vs2019,
11 IDETypes.vs2022)

List of IDETypes the visual_studio module supports.