mirror of
https://github.com/python/cpython
synced 2024-11-02 05:41:35 +00:00
f6d9e5926b
Add an option (--enable-experimental-jit for configure-based builds or --experimental-jit for PCbuild-based ones) to build an *experimental* just-in-time compiler, based on copy-and-patch (https://fredrikbk.com/publications/copy-and-patch.pdf). See Tools/jit/README.md for more information on how to install the required build-time tooling.
192 lines
No EOL
7.5 KiB
Batchfile
192 lines
No EOL
7.5 KiB
Batchfile
@echo off
|
|
goto Run
|
|
:Usage
|
|
echo.%~nx0 [flags and arguments] [quoted MSBuild options]
|
|
echo.
|
|
echo.Build CPython from the command line. Requires the appropriate
|
|
echo.version(s) of Microsoft Visual Studio to be installed (see readme.txt).
|
|
echo.
|
|
echo.After the flags recognized by this script, up to 9 arguments to be passed
|
|
echo.directly to MSBuild may be passed. If the argument contains an '=', the
|
|
echo.entire argument must be quoted (e.g. `%~nx0 "/p:PlatformToolset=v100"`).
|
|
echo.Alternatively you can put extra flags for MSBuild in a file named
|
|
echo.`msbuild.rsp` in the `PCbuild` directory, one flag per line. This file
|
|
echo.will be picked automatically by MSBuild. Flags put in this file does not
|
|
echo.need to be quoted. You can still use environment variables inside the
|
|
echo.response file.
|
|
echo.
|
|
echo.Available flags:
|
|
echo. -h Display this help message
|
|
echo. -V Display version information for the current build
|
|
echo. -r Target Rebuild instead of Build
|
|
echo. -d Set the configuration to Debug
|
|
echo. -E Don't fetch or build external libraries. Extension modules that
|
|
echo. depend on external libraries will not attempt to build if this flag
|
|
echo. is present; -e is also accepted to explicitly enable fetching and
|
|
echo. building externals.
|
|
echo. -m Enable parallel build (enabled by default)
|
|
echo. -M Disable parallel build
|
|
echo. -v Increased output messages
|
|
echo. -vv Verbose output messages
|
|
echo. -q Quiet output messages (errors and warnings only)
|
|
echo. -k Attempt to kill any running Pythons before building (usually done
|
|
echo. automatically by the pythoncore project)
|
|
echo. --pgo Build with Profile-Guided Optimization. This flag
|
|
echo. overrides -c and -d
|
|
echo. --disable-gil Enable experimental support for running without the GIL.
|
|
echo. --test-marker Enable the test marker within the build.
|
|
echo. --regen Regenerate all opcodes, grammar and tokens.
|
|
echo. --experimental-jit Enable the experimental just-in-time compiler.
|
|
echo.
|
|
echo.Available flags to avoid building certain modules.
|
|
echo.These flags have no effect if '-e' is not given:
|
|
echo. --no-ctypes Do not attempt to build _ctypes
|
|
echo. --no-ssl Do not attempt to build _ssl
|
|
echo. --no-tkinter Do not attempt to build Tkinter
|
|
echo.
|
|
echo.Available arguments:
|
|
echo. -c Release ^| Debug ^| PGInstrument ^| PGUpdate
|
|
echo. Set the configuration (default: Release)
|
|
echo. -p x64 ^| Win32 ^| ARM ^| ARM64
|
|
echo. Set the platform (default: x64)
|
|
echo. -t Build ^| Rebuild ^| Clean ^| CleanAll
|
|
echo. Set the target manually
|
|
echo. --pgo-job The job to use for PGO training; implies --pgo
|
|
echo. (default: "-m test --pgo")
|
|
exit /b 127
|
|
|
|
:Run
|
|
setlocal
|
|
set platf=x64
|
|
set conf=Release
|
|
set target=Build
|
|
set dir=%~dp0
|
|
set parallel=/m
|
|
set verbose=/nologo /v:m /clp:summary
|
|
set kill=
|
|
set do_pgo=
|
|
set pgo_job=-m test --pgo
|
|
|
|
:CheckOpts
|
|
if "%~1"=="-h" goto Usage
|
|
if "%~1"=="-c" (set conf=%2) & shift & shift & goto CheckOpts
|
|
if "%~1"=="-p" (set platf=%2) & shift & shift & goto CheckOpts
|
|
if "%~1"=="-r" (set target=Rebuild) & shift & goto CheckOpts
|
|
if "%~1"=="-t" (set target=%2) & shift & shift & goto CheckOpts
|
|
if "%~1"=="-d" (set conf=Debug) & shift & goto CheckOpts
|
|
if "%~1"=="-m" (set parallel=/m) & shift & goto CheckOpts
|
|
if "%~1"=="-M" (set parallel=) & shift & goto CheckOpts
|
|
if "%~1"=="-v" (set verbose=/v:n) & shift & goto CheckOpts
|
|
if "%~1"=="-vv" (set verbose=/v:d /ds) & shift & goto CheckOpts
|
|
if "%~1"=="-q" (set verbose=/v:q /nologo /clp:summary) & shift & goto CheckOpts
|
|
if "%~1"=="-k" (set kill=true) & shift & goto CheckOpts
|
|
if "%~1"=="--pgo" (set do_pgo=true) & shift & goto CheckOpts
|
|
if "%~1"=="--pgo-job" (set do_pgo=true) & (set pgo_job=%~2) & shift & shift & goto CheckOpts
|
|
if "%~1"=="--disable-gil" (set UseDisableGil=true) & shift & goto CheckOpts
|
|
if "%~1"=="--test-marker" (set UseTestMarker=true) & shift & goto CheckOpts
|
|
if "%~1"=="-V" shift & goto Version
|
|
if "%~1"=="--regen" (set Regen=true) & shift & goto CheckOpts
|
|
if "%~1"=="--experimental-jit" (set UseJIT=true) & shift & goto CheckOpts
|
|
rem These use the actual property names used by MSBuild. We could just let
|
|
rem them in through the environment, but we specify them on the command line
|
|
rem anyway for visibility so set defaults after this
|
|
if "%~1"=="-e" (set IncludeExternals=true) & shift & goto CheckOpts
|
|
if "%~1"=="-E" (set IncludeExternals=false) & shift & goto CheckOpts
|
|
if "%~1"=="--no-ctypes" (set IncludeCTypes=false) & shift & goto CheckOpts
|
|
if "%~1"=="--no-ssl" (set IncludeSSL=false) & shift & goto CheckOpts
|
|
if "%~1"=="--no-tkinter" (set IncludeTkinter=false) & shift & goto CheckOpts
|
|
|
|
if "%IncludeExternals%"=="" set IncludeExternals=true
|
|
if "%IncludeCTypes%"=="" set IncludeCTypes=true
|
|
if "%IncludeSSL%"=="" set IncludeSSL=true
|
|
if "%IncludeTkinter%"=="" set IncludeTkinter=true
|
|
|
|
if "%IncludeExternals%"=="true" call "%dir%get_externals.bat"
|
|
|
|
if "%do_pgo%" EQU "true" if "%platf%" EQU "x64" (
|
|
if "%PROCESSOR_ARCHITEW6432%" NEQ "AMD64" if "%PROCESSOR_ARCHITECTURE%" NEQ "AMD64" (
|
|
echo.ERROR: Cannot cross-compile with PGO
|
|
echo. 32bit operating system detected. Ensure your PROCESSOR_ARCHITECTURE
|
|
echo. and PROCESSOR_ARCHITEW6432 environment variables are correct.
|
|
exit /b 1
|
|
)
|
|
)
|
|
|
|
if not exist "%GIT%" where git > "%TEMP%\git.loc" 2> nul && set /P GIT= < "%TEMP%\git.loc" & del "%TEMP%\git.loc"
|
|
if exist "%GIT%" set GITProperty=/p:GIT="%GIT%"
|
|
if not exist "%GIT%" echo Cannot find Git on PATH & set GITProperty=
|
|
|
|
rem Setup the environment
|
|
call "%dir%find_msbuild.bat" %MSBUILD%
|
|
if ERRORLEVEL 1 (echo Cannot locate MSBuild.exe on PATH or as MSBUILD variable & exit /b 2)
|
|
|
|
call "%dir%find_python.bat" %PYTHON%
|
|
if ERRORLEVEL 1 (echo Cannot locate python.exe on PATH or as PYTHON variable & exit /b 3)
|
|
set PythonForBuild=%PYTHON%
|
|
|
|
if "%kill%"=="true" call :Kill
|
|
if ERRORLEVEL 1 exit /B %ERRORLEVEL%
|
|
|
|
if "%regen%"=="true" goto :Regen
|
|
|
|
if "%do_pgo%"=="true" (
|
|
set conf=PGInstrument
|
|
call :Build %1 %2 %3 %4 %5 %6 %7 %8 %9
|
|
)
|
|
rem %VARS% are evaluated eagerly, which would lose the ERRORLEVEL
|
|
rem value if we didn't split it out here.
|
|
if "%do_pgo%"=="true" if ERRORLEVEL 1 exit /B %ERRORLEVEL%
|
|
if "%do_pgo%"=="true" (
|
|
del /s "%dir%\*.pgc"
|
|
del /s "%dir%\..\Lib\*.pyc"
|
|
echo on
|
|
call "%dir%\..\python.bat" %pgo_job%
|
|
@echo off
|
|
call :Kill
|
|
set conf=PGUpdate
|
|
set target=Build
|
|
)
|
|
goto :Build
|
|
|
|
:Kill
|
|
echo on
|
|
%MSBUILD% "%dir%\pythoncore.vcxproj" /t:KillPython %verbose%^
|
|
/p:Configuration=%conf% /p:Platform=%platf%^
|
|
/p:KillPython=true
|
|
|
|
@echo off
|
|
exit /B %ERRORLEVEL%
|
|
|
|
:Regen
|
|
echo on
|
|
%MSBUILD% "%dir%\pythoncore.vcxproj" /t:Regen %verbose%^
|
|
/p:Configuration=%conf% /p:Platform=%platf%^
|
|
/p:ForceRegen=true
|
|
|
|
@echo off
|
|
exit /B %ERRORLEVEL%
|
|
|
|
:Build
|
|
rem Call on MSBuild to do the work, echo the command.
|
|
rem Passing %1-9 is not the preferred option, but argument parsing in
|
|
rem batch is, shall we say, "lackluster"
|
|
echo on
|
|
%MSBUILD% "%dir%pcbuild.proj" /t:%target% %parallel% %verbose%^
|
|
/p:Configuration=%conf% /p:Platform=%platf%^
|
|
/p:IncludeExternals=%IncludeExternals%^
|
|
/p:IncludeCTypes=%IncludeCTypes%^
|
|
/p:IncludeSSL=%IncludeSSL% /p:IncludeTkinter=%IncludeTkinter%^
|
|
/p:DisableGil=%UseDisableGil%^
|
|
/p:UseTestMarker=%UseTestMarker% %GITProperty%^
|
|
/p:UseJIT=%UseJIT%^
|
|
%1 %2 %3 %4 %5 %6 %7 %8 %9
|
|
|
|
@echo off
|
|
exit /b %ERRORLEVEL%
|
|
|
|
:Version
|
|
rem Display the current build version information
|
|
call "%dir%find_msbuild.bat" %MSBUILD%
|
|
if ERRORLEVEL 1 (echo Cannot locate MSBuild.exe on PATH or as MSBUILD variable & exit /b 2)
|
|
%MSBUILD% "%dir%pythoncore.vcxproj" /t:ShowVersionInfo /v:m /nologo %1 %2 %3 %4 %5 %6 %7 %8 %9
|
|
if ERRORLEVEL 1 exit /b 3 |