FazBrowse GitHub Viewer
|
Trending
|
URL:
|
Home
Tools:
[Download Repo ZIP]
[View Raw Code]
[Original HTTPS Page]
setup-python/src/find-python.ts at main · useblacksmith/setup-python · GitHub
Uh oh!
There was an error while loading.
Please reload this page
.
This repository was archived by the owner on Oct 14, 2025. It is now read-only.
useblacksmith
/
setup-python
Public archive
forked from
actions/setup-python
Notifications
You must be signed in to change notification settings
Fork
0
Star
1
Code
Pull requests
2
Projects
Security and quality
0
Insights
Additional navigation options
Code
Pull requests
Projects
Security and quality
Insights
Expand file tree
Breadcrumbs
setup-python
/
src
/
find-python.ts
Copy path
More file actions
More file actions
Latest commit
History
History
History
245 lines (218 loc) · 8.07 KB
Breadcrumbs
setup-python
/
src
/
find-python.ts
Copy path
File metadata and controls
245 lines (218 loc) · 8.07 KB
Raw
Copy raw file
Download raw file
Open symbols panel
Edit and raw actions
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
import
*
as
os
from
'os'
;
import
*
as
path
from
'path'
;
import
{
IS_WINDOWS
,
IS_LINUX
,
getOSInfo
}
from
'./utils'
;
import
*
as
semver
from
'semver'
;
import
*
as
installer
from
'./install-python'
;
import
*
as
core
from
'@actions/core'
;
import
*
as
tc
from
'@actions/tool-cache'
;
// Python has "scripts" or "bin" directories where command-line tools that come with packages are installed.
// This is where pip is, along with anything that pip installs.
// There is a separate directory for `pip install --user`.
//
// For reference, these directories are as follows:
// macOS / Linux:
// <sys.prefix>/bin (by default /usr/local/bin, but not on hosted agents -- see the `else`)
// (--user) ~/.local/bin
// Windows:
// <Python installation dir>\Scripts
// (--user) %APPDATA%\Python\PythonXY\Scripts
// See https://docs.python.org/3/library/sysconfig.html
function
binDir
(
installDir
:
string
)
:
string
{
if
(
IS_WINDOWS
)
{
return
path
.
join
(
installDir
,
'Scripts'
)
;
}
else
{
return
path
.
join
(
installDir
,
'bin'
)
;
}
}
export
async
function
useCpythonVersion
(
version
:
string
,
architecture
:
string
,
updateEnvironment
:
boolean
,
checkLatest
:
boolean
,
allowPreReleases
:
boolean
,
freethreaded
:
boolean
)
:
Promise
<
InstalledVersion
>
{
let
manifest
:
tc
.
IToolRelease
[
]
|
null
=
null
;
const
{
version
:
desugaredVersionSpec
,
freethreaded
:
versionFreethreaded
}
=
desugarVersion
(
version
)
;
let
semanticVersionSpec
=
pythonVersionToSemantic
(
desugaredVersionSpec
,
allowPreReleases
)
;
if
(
versionFreethreaded
)
{
// Use the freethreaded version if it was specified in the input, e.g., 3.13t
freethreaded
=
true
;
}
core
.
debug
(
`Semantic version spec of
${
version
}
is
${
semanticVersionSpec
}
`
)
;
if
(
freethreaded
)
{
// Free threaded versions use an architecture suffix like `x64-freethreaded`
core
.
debug
(
`Using freethreaded version of
${
semanticVersionSpec
}
`
)
;
architecture
+=
'-freethreaded'
;
}
if
(
checkLatest
)
{
manifest
=
await
installer
.
getManifest
(
)
;
const
resolvedVersion
=
(
await
installer
.
findReleaseFromManifest
(
semanticVersionSpec
,
architecture
,
manifest
)
)
?.
version
;
if
(
resolvedVersion
)
{
semanticVersionSpec
=
resolvedVersion
;
core
.
info
(
`Resolved as '
${
semanticVersionSpec
}
'`
)
;
}
else
{
core
.
info
(
`Failed to resolve version
${
semanticVersionSpec
}
from manifest`
)
;
}
}
let
installDir
:
string
|
null
=
tc
.
find
(
'Python'
,
semanticVersionSpec
,
architecture
)
;
if
(
!
installDir
)
{
core
.
info
(
`Version
${
semanticVersionSpec
}
was not found in the local cache`
)
;
const
foundRelease
=
await
installer
.
findReleaseFromManifest
(
semanticVersionSpec
,
architecture
,
manifest
)
;
if
(
foundRelease
&&
foundRelease
.
files
&&
foundRelease
.
files
.
length
>
0
)
{
core
.
info
(
`Version
${
semanticVersionSpec
}
is available for downloading`
)
;
await
installer
.
installCpythonFromRelease
(
foundRelease
)
;
installDir
=
tc
.
find
(
'Python'
,
semanticVersionSpec
,
architecture
)
;
}
}
if
(
!
installDir
)
{
const
osInfo
=
await
getOSInfo
(
)
;
const
msg
=
[
`The version '
${
version
}
' with architecture '
${
architecture
}
' was not found for
${
osInfo
?
`
${
osInfo
.
osName
}
${
osInfo
.
osVersion
}
`
:
'this operating system'
}
.`
]
;
if
(
freethreaded
)
{
msg
.
push
(
`Free threaded versions are only available for Python 3.13.0 and later.`
)
;
}
msg
.
push
(
`The list of all available versions can be found here:
${
installer
.
MANIFEST_URL
}
`
)
;
throw
new
Error
(
msg
.
join
(
os
.
EOL
)
)
;
}
const
_binDir
=
binDir
(
installDir
)
;
const
binaryExtension
=
IS_WINDOWS
?
'.exe'
:
''
;
const
pythonPath
=
path
.
join
(
IS_WINDOWS
?
installDir
:
_binDir
,
`python
${
binaryExtension
}
`
)
;
if
(
updateEnvironment
)
{
core
.
exportVariable
(
'pythonLocation'
,
installDir
)
;
core
.
exportVariable
(
'PKG_CONFIG_PATH'
,
installDir
+
'/lib/pkgconfig'
)
;
core
.
exportVariable
(
'pythonLocation'
,
installDir
)
;
// https://cmake.org/cmake/help/latest/module/FindPython.html#module:FindPython
core
.
exportVariable
(
'Python_ROOT_DIR'
,
installDir
)
;
// https://cmake.org/cmake/help/latest/module/FindPython2.html#module:FindPython2
core
.
exportVariable
(
'Python2_ROOT_DIR'
,
installDir
)
;
// https://cmake.org/cmake/help/latest/module/FindPython3.html#module:FindPython3
core
.
exportVariable
(
'Python3_ROOT_DIR'
,
installDir
)
;
core
.
exportVariable
(
'PKG_CONFIG_PATH'
,
installDir
+
'/lib/pkgconfig'
)
;
if
(
IS_LINUX
)
{
const
libPath
=
process
.
env
.
LD_LIBRARY_PATH
?
`:
${
process
.
env
.
LD_LIBRARY_PATH
}
`
:
''
;
const
pyLibPath
=
path
.
join
(
installDir
,
'lib'
)
;
if
(
!
libPath
.
split
(
':'
)
.
includes
(
pyLibPath
)
)
{
core
.
exportVariable
(
'LD_LIBRARY_PATH'
,
pyLibPath
+
libPath
)
;
}
}
core
.
addPath
(
installDir
)
;
core
.
addPath
(
_binDir
)
;
if
(
IS_WINDOWS
)
{
// Add --user directory
// `installDir` from tool cache should look like $RUNNER_TOOL_CACHE/Python/<semantic version>/x64/
// So if `findLocalTool` succeeded above, we must have a conformant `installDir`
const
version
=
path
.
basename
(
path
.
dirname
(
installDir
)
)
;
const
major
=
semver
.
major
(
version
)
;
const
minor
=
semver
.
minor
(
version
)
;
const
userScriptsDir
=
path
.
join
(
process
.
env
[
'APPDATA'
]
||
''
,
'Python'
,
`Python
${
major
}
${
minor
}
`
,
'Scripts'
)
;
core
.
addPath
(
userScriptsDir
)
;
}
// On Linux and macOS, pip will create the --user directory and add it to PATH as needed.
}
const
installed
=
versionFromPath
(
installDir
)
;
let
pythonVersion
=
installed
;
if
(
freethreaded
)
{
// Add the freethreaded suffix to the version (e.g., 3.13.1t)
pythonVersion
+=
't'
;
}
core
.
setOutput
(
'python-version'
,
pythonVersion
)
;
core
.
setOutput
(
'python-path'
,
pythonPath
)
;
return
{
impl
:
'CPython'
,
version
:
pythonVersion
}
;
}
/* Desugar free threaded and dev versions */
export
function
desugarVersion
(
versionSpec
:
string
)
{
const
{
version
,
freethreaded
}
=
desugarFreeThreadedVersion
(
versionSpec
)
;
return
{
version
:
desugarDevVersion
(
version
)
,
freethreaded
}
;
}
/* Identify freethreaded versions like, 3.13t, 3.13.1t, 3.13t-dev.
* Returns the version without the `t` and the architectures suffix, if freethreaded */
function
desugarFreeThreadedVersion
(
versionSpec
:
string
)
{
const
majorMinor
=
/
^
(
\d
+
\.
\d
+
(
\.
\d
+
)
?
)
(
t
)
$
/
;
if
(
majorMinor
.
test
(
versionSpec
)
)
{
return
{
version
:
versionSpec
.
replace
(
majorMinor
,
'$1'
)
,
freethreaded
:
true
}
;
}
const
devVersion
=
/
^
(
\d
+
\.
\d
+
)
(
t
)
(
-
d
e
v
)
$
/
;
if
(
devVersion
.
test
(
versionSpec
)
)
{
return
{
version
:
versionSpec
.
replace
(
devVersion
,
'$1$3'
)
,
freethreaded
:
true
}
;
}
return
{
version
:
versionSpec
,
freethreaded
:
false
}
;
}
/** Convert versions like `3.8-dev` to a version like `~3.8.0-0`. */
function
desugarDevVersion
(
versionSpec
:
string
)
{
const
devVersion
=
/
^
(
\d
+
)
\.
(
\d
+
)
-
d
e
v
$
/
;
return
versionSpec
.
replace
(
devVersion
,
'~$1.$2.0-0'
)
;
}
/** Extracts python version from install path from hosted tool cache as described in README.md */
function
versionFromPath
(
installDir
:
string
)
{
const
parts
=
installDir
.
split
(
path
.
sep
)
;
const
idx
=
parts
.
findIndex
(
part
=>
part
===
'PyPy'
||
part
===
'Python'
)
;
return
parts
[
idx
+
1
]
||
''
;
}
interface
InstalledVersion
{
impl
:
string
;
version
:
string
;
}
/**
* Python's prelease versions look like `3.7.0b2`.
* This is the one part of Python versioning that does not look like semantic versioning, which specifies `3.7.0-b2`.
* If the version spec contains prerelease versions, we need to convert them to the semantic version equivalent.
*
* For easier use of the action, we also map 'x.y' to allow pre-release before 'x.y.0' release if allowPreReleases is true
*/
export
function
pythonVersionToSemantic
(
versionSpec
:
string
,
allowPreReleases
:
boolean
)
{
const
prereleaseVersion
=
/
(
\d
+
\.
\d
+
\.
\d
+
)
(
(?:
a
|
b
|
r
c
)
\d
*
)
/
g
;
const
majorMinor
=
/
^
(
\d
+
)
\.
(
\d
+
)
$
/
;
let
result
=
versionSpec
.
replace
(
prereleaseVersion
,
'$1-$2'
)
;
if
(
allowPreReleases
)
{
result
=
result
.
replace
(
majorMinor
,
'~$1.$2.0-0'
)
;
}
return
result
;
}
Back
|
FazBrowse Home
|
New Git URL