Skip to content

Commit

Permalink
Revert changes
Browse files Browse the repository at this point in the history
  • Loading branch information
IvanZosimov committed Jul 26, 2022
1 parent 853c012 commit fe396d3
Showing 1 changed file with 12 additions and 11 deletions.
23 changes: 12 additions & 11 deletions docs/advanced-usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@

## Specifying a Python version

- 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`):
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`):

```yaml
steps:
Expand All @@ -31,10 +31,11 @@ steps:
python-version: '3.7.5'
- run: python my_script.py
```
- 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.
- MSI installers are used on Windows for this, so runs will take a little longer to set up vs MacOS and Linux.

- You can specify **only a major and minor version** if you are okay with the most recent patch version being used:
- 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.
- MSI installers are used on Windows for this, so runs will take a little longer to set up vs MacOS and Linux.

You can specify **only a major and minor version** if you are okay with the most recent patch version being used:

```yaml
steps:
Expand All @@ -44,11 +45,11 @@ steps:
python-version: '3.7'
- run: python my_script.py
```
- There will be a single patch version already installed on each runner for every minor version of Python that is supported.
- 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.
- 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.
- There will be a single patch version already installed on each runner for every minor version of Python that is supported.
- 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.
- 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.

- You can specify the version with **prerelease tag** to download and set up an accurate pre-release version of Python:
You can specify the version with **prerelease tag** to download and set up an accurate pre-release version of Python:

```yaml
steps:
Expand All @@ -59,7 +60,7 @@ steps:
- run: python my_script.py
```

- 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):
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):

```yaml
steps:
Expand All @@ -70,7 +71,7 @@ steps:
- run: python my_script.py
```

- You can also use several types of ranges that are specified in [semver](https://github.com/npm/node-semver#ranges), for instance:
You can also use several types of ranges that are specified in [semver](https://github.com/npm/node-semver#ranges), for instance:

- **[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):

Expand All @@ -83,7 +84,7 @@ steps:
- run: python my_script.py
```

- **[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):
**[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):

```yaml
steps:
Expand Down

0 comments on commit fe396d3

Please sign in to comment.