8000 Updating to work with BuildJet's cache package - v5.1.1 · BuildJet/setup-python@ebe371f · GitHub
[go: up one dir, main page]

Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit ebe371f

Browse files
committed
Updating to work with BuildJet's cache package - v5.1.1
1 parent 39cd149 commit ebe371f

File tree

6 files changed

+43444
-142040
lines changed

6 files changed

+43444
-142040
lines changed

README.md

Lines changed: 9 additions & 105 deletions
Original file line numberDiff line numberDiff line change
@@ -1,108 +1,12 @@
1-
# setup-python
1+
<div align="center">
2+
<img src="https://buildjet.com/buildjet-for-github-actions-logo2.svg" height="38">
3+
</div>
24

3-
[![Basic validation](https://github.com/actions/setup-python/actions/workflows/basic-validation.yml/badge.svg?branch=main)](https://github.com/actions/setup-python/actions/workflows/basic-validation.yml)
4-
[![Validate Python e2e](https://github.com/actions/setup-python/actions/workflows/test-python.yml/badge.svg?branch=main)](https://github.com/actions/setup-python/actions/workflows/test-python.yml)
5-
[![Validate PyPy e2e](https://github.com/actions/setup-python/actions/workflows/test-pypy.yml/badge.svg?branch=main)](https://github.com/actions/setup-python/actions/workflows/test-pypy.yml)
6-
[![e2e-cache](https://github.com/actions/setup-python/actions/workflows/e2e-cache.yml/badge.svg?branch=main)](https://github.com/actions/setup-python/actions/workflows/e2e-cache.yml)
5+
---
76

8-
This action provides the following functionality for GitHub Actions users:
7+
This is a fork by [BuildJet for GitHub Actions](https://buildjet.com/for-github-actions).
8+
It is **fully compatible with the official setup-python action**, simply replace `actions/setup-python` with `buildjet/setup-python`.
9+
Under the hood we simply switch the underlying caching package to our fully compatible `buildjet/cache`. No other changes have been made to this package.
910

10-
- Installing a version of Python or PyPy and (by default) adding it to the PATH
11-
- Optionally caching dependencies for pip, pipenv and poetry
12-
- Registering problem matchers for error output
13-
14-
## Basic usage
15-
16-
See [action.yml](action.yml)
17-
18-
**Python**
19-
```yaml
20-
steps:
21-
- uses: actions/checkout@v4
22-
- uses: actions/setup-python@v5
23-
with:
24-
python-version: '3.10'
25-
- run: python my_script.py
26-
```
27-
28-
**PyPy**
29-
```yaml
30-
steps:
31-
- uses: actions/checkout@v4
32-
- uses: actions/setup-python@v5
33-
with:
34-
python-version: 'pypy3.9'
35-
- run: python my_script.py
36-
```
37-
38-
**GraalPy**
39-
```yaml
40-
steps:
41-
- uses: actions/checkout@v4
42-
- uses: actions/setup-python@v5
43-
with:
44-
python-version: 'graalpy-22.3'
45-
- run: python my_script.py
46-
```
47-
48-
The `python-version` input is optional. If not supplied, the action will try to resolve the version from the default `.python-version` file. If the `.python-version` file doesn't exist Python or PyPy version from the PATH will be used. The default version of Python or PyPy in PATH varies between runners and can be changed unexpectedly so we recommend always setting Python version explicitly using the `python-version` or `python-version-file` inputs.
49-
50-
The action will first check the local [tool cache](docs/advanced-usage.md#hosted-tool-cache) for a [semver](https://github.com/npm/node-semver#versions) match. If unable to find a specific version in the tool cache, the action will attempt to download a version of Python from [GitHub Releases](https://github.com/actions/python-versions/releases) and for PyPy from the official [PyPy's dist](https://downloads.python.org/pypy/).
51-
52-
For information regarding locally cached versions of Python or PyPy on GitHub hosted runners, check out [GitHub Actions Runner Images](https://github.com/actions/runner-images).
53-
54-
## Supported version syntax
55-
56-
The `python-version` input supports the [Semantic Versioning Specification](https://semver.org/) and some special version notations (e.g. `semver ranges`, `x.y-dev syntax`, etc.), for detailed examples please refer to the section: [Using python-version input](docs/advanced-usage.md#using-the-python-version-input) of the [Advanced usage](docs/advanced-usage.md) guide.
57-
58-
## Supported architectures
59-
60-
Using `architecture` input it is possible to specify the required Python or PyPy interpreter architecture: `x86` or `x64`. If the input is not specified the architecture defaults to `x64`.
61-
62-
## Caching packages dependencies
63-
64-
The action has built-in functionality for caching and restoring dependencies. It uses [toolkit/cache](https://github.com/actions/toolkit/tree/main/packages/cache) under the hood for caching dependencies but requires less configuration settings. Supported package managers are `pip`, `pipenv` and `poetry`. The `cache` input is optional, and caching is turned off by default.
65-
66-
The action defaults to searching for a dependency file (`requirements.txt` or `pyproject.toml` for pip, `Pipfile.lock` for pipenv or `poetry.lock` for poetry) in the repository, and uses its hash as a part of the cache key. Input `cache-dependency-path` is used for cases when multiple dependency files are used, they are located in different subdirectories or different files for the hash that want to be used.
67-
68-
- For `pip`, the action will cache the global cache directory
69-
- For `pipenv`, the action will cache virtualenv directory
70-
- For `poetry`, the action will cache virtualenv directories -- one for each poetry project found
71-
72-
**Caching pip dependencies:**
73-
74-
```yaml
75-
steps:
76-
- uses: actions/checkout@v4
77-
- uses: actions/setup-python@v5
78-
with:
79-
python-version: '3.9'
80-
cache: 'pip' # caching pip dependencies
81-
- run: pip install -r requirements.txt
82-
```
83-
>**Note:** Restored cache will not be used if the requirements.txt file is not updated for a long time and a newer version of the dependency is available which can lead to an increase in total build time.
84-
85-
>The requirements file format allows for specifying dependency versions using logical operators (for example chardet>=3.0.4) or specifying dependencies without any versions. In this case the pip install -r requirements.txt command will always try to install the latest available package version. To be sure that the cache will be used, please stick to a specific dependency version and update it manually if necessary.
86-
87-
See examples of using `cache` and `cache-dependency-path` for `pipenv` and `poetry` in the section: [Caching packages](docs/advanced-usage.md#caching-packages) of the [Advanced usage](docs/advanced-usage.md) guide.
88-
89-
## Advanced usage
90-
91-
- [Using the python-version input](docs/advanced-usage.md#using-the-python-version-input)
92-
- [Using the python-version-file input](docs/advanced-usage.md#using-the-python-version-file-input)
93-
- [Check latest version](docs/advanced-usage.md#check-latest-version)
94-
- [Caching packages](docs/advanced-usage.md#caching-packages)
95-
- [Outputs and environment variables](docs/advanced-usage.md#outputs-and-environment-variables)
96-
- [Available versions of Python, PyPy and GraalPy](docs/advanced-usage.md#available-versions-of-python-pypy-and-graalpy)
97-
- [Hosted tool cache](docs/advanced-usage.md#hosted-tool-cache)
98-
- [Using `setup-python` with a self-hosted runner](docs/advanced-usage.md#using-setup-python-with-a-self-hosted-runner)
99-
- [Using `setup-python` on GHES](docs/advanced-usage.md#using-setup-python-on-ghes)
100-
- [Allow pre-releases](docs/advanced-usage.md#allow-pre-releases)
101-
102-
## License
103-
104-
The scripts and documentation in this project are released under the [MIT License](LICENSE).
105-
106-
## Contributions
107-
108-
Contributions are welcome! See our [Contributor's Guide](docs/contributors.md).
11+
For help migrating to BuildJet's setup-python, please visit our [migration guide](https://buildjet.com/for-github-actions/docs/guides/migrating-to-buildjet-cache).
12+
For detailed usage instructions, please visit the [official `actions/setup-python` repository](https://github.com/actions/setup-python).

0 commit comments

Comments
 (0)
0