|
1 |
| -# Table of contents |
| 1 | +# Contents |
2 | 2 | - [Using python-version input](advanced-usage.md#using-python-version-file-input)
|
3 | 3 | - [Specifying a Python version](advanced-usage.md#specifying-a-python-version)
|
4 | 4 | - [Specifying a PyPy version](advanced-usage.md#specifying-a-pypy-version)
|
|
19 | 19 |
|
20 | 20 | # Using python-version input
|
21 | 21 |
|
22 |
| -The `python-version` input is used to specify the required version of Python or PyPy. |
23 |
| - |
24 | 22 | ## Specifying a Python version
|
25 | 23 |
|
26 |
| -If there is a specific version of Python that you need and you don't want to worry about any potential breaking changes due to patch updates (going from `3.7.5` to `3.7.6` for example), you should specify the **exact major, minor, and patch version** (such as `3.7.5`): |
| 24 | +If there is a specific version of Python that you need and you don't want to worry about any potential breaking changes due to patch updates (going from `3.7.5` to `3.7.6` for example), you should specify the ***exact major, minor, and patch version*** (such as `3.7.5`): |
27 | 25 |
|
28 | 26 | ```yaml
|
29 | 27 | steps:
|
|
36 | 34 | - The only downside to this is that set-up will take a little longer since the exact version will have to be downloaded if the exact version is not already installed on the runner due to more recent versions.
|
37 | 35 | - MSI installers are used on Windows for this, so runs will take a little longer to set up vs MacOS and Linux.
|
38 | 36 |
|
39 |
| -You can specify **only a major and minor version** if you are okay with the most recent patch version being used: |
| 37 | +You can specify ***only a major and minor version*** if you are okay with the most recent patch version being used: |
40 | 38 |
|
41 | 39 | ```yaml
|
42 | 40 | steps:
|
|
50 | 48 | - The patch version that will be preinstalled, will generally be the latest and every time there is a new patch released, the older version that is preinstalled will be replaced.
|
51 | 49 | - Using the most recent patch version will result in a very quick setup since no downloads will be required since a locally installed version of Python on the runner will be used.
|
52 | 50 |
|
53 |
| -You can specify the version with **prerelease tag** to download and set up an accurate pre-release version of Python: |
| 51 | +You can specify the version with ***prerelease tag*** to download and set up an accurate pre-release version of Python: |
54 | 52 |
|
55 | 53 | ```yaml
|
56 | 54 | steps:
|
|
61 | 59 | - run: python my_script.py
|
62 | 60 | ```
|
63 | 61 |
|
64 |
| -It's also possible to use **x.y-dev syntax** to download and set up the latest patch version of Python, alpha and beta releases included. (for specified major & minor versions): |
| 62 | +It's also possible to use ***x.y-dev syntax*** to download and set up the latest patch version of Python, alpha and beta releases included. (for specified major & minor versions): |
65 | 63 |
|
66 | 64 | ```yaml
|
67 | 65 | steps:
|
|
74 | 72 |
|
75 | 73 | You can also use several types of ranges that are specified in [semver](https://github.com/npm/node-semver#ranges), for instance:
|
76 | 74 |
|
77 |
| -- **[hyphen ranges](https://github.com/npm/node-semver#hyphen-ranges-xyz---abc)** to download and set up the latest available version of Python (includes both pre-release and stable versions): |
| 75 | +- ***[hyphen ranges](https://github.com/npm/node-semver#hyphen-ranges-xyz---abc)*** to download and set up the latest available version of Python (includes both pre-release and stable versions): |
78 | 76 |
|
79 | 77 | ```yaml
|
80 | 78 | steps:
|
|
85 | 83 | - run: python my_script.py
|
86 | 84 | ```
|
87 | 85 |
|
88 |
| -- **[x-ranges](https://github.com/npm/node-semver#x-ranges-12x-1x-12-)** to specify the latest stable version of Python (for specified major version): |
| 86 | +- ***[x-ranges](https://github.com/npm/node-semver#x-ranges-12x-1x-12-)*** to specify the latest stable version of Python (for specified major version): |
89 | 87 |
|
90 | 88 | ```yaml
|
91 | 89 | steps:
|
|
0 commit comments