From 8bcd2560e267a43fbd8ff66c50da8a61825a0782 Mon Sep 17 00:00:00 2001 From: Vladimir Safonkin Date: Tue, 18 Oct 2022 11:01:15 +0200 Subject: [PATCH 1/7] Add architecture input check for PyPy for Windows platform (#520) * Revert cache index.js * build cache index file * Refactor * Debug * Debug * Debug * Debug * Debug * Debug * Debug * Debug * Format code * Rebuild dist * Minor refactor * Format code * Minor fixes * Check platform firstly --- dist/setup/index.js | 23 +++++++++++++++-------- src/install-pypy.ts | 25 ++++++++++++++++--------- 2 files changed, 31 insertions(+), 17 deletions(-) diff --git a/dist/setup/index.js b/dist/setup/index.js index d92820713..f153c3c24 100644 --- a/dist/setup/index.js +++ b/dist/setup/index.js @@ -66577,7 +66577,7 @@ function findRelease(releases, pythonVersion, pypyVersion, architecture) { semver.satisfies(pypyVersionToSemantic(item.pypy_version), pypyVersion); const isArchPresent = item.files && (utils_1.IS_WINDOWS - ? isArchPresentForWindows(item) + ? isArchPresentForWindows(item, architecture) : isArchPresentForMacOrLinux(item, architecture, process.platform)); return isPythonVersionSatisfied && isPyPyVersionSatisfied && isArchPresent; }); @@ -66590,7 +66590,7 @@ function findRelease(releases, pythonVersion, pypyVersion, architecture) { }); const foundRelease = sortedReleases[0]; const foundAsset = utils_1.IS_WINDOWS - ? findAssetForWindows(foundRelease) + ? findAssetForWindows(foundRelease, architecture) : findAssetForMacOrLinux(foundRelease, architecture, process.platform); return { foundAsset, @@ -66613,24 +66613,31 @@ function pypyVersionToSemantic(versionSpec) { return versionSpec.replace(prereleaseVersion, '$1-$2.$3'); } exports.pypyVersionToSemantic = pypyVersionToSemantic; -function isArchPresentForWindows(item) { - return item.files.some((file) => utils_1.WINDOWS_ARCHS.includes(file.arch) && - utils_1.WINDOWS_PLATFORMS.includes(file.platform)); +function isArchPresentForWindows(item, architecture) { + architecture = replaceX32toX86(architecture); + return item.files.some((file) => utils_1.WINDOWS_PLATFORMS.includes(file.platform) && file.arch === architecture); } exports.isArchPresentForWindows = isArchPresentForWindows; function isArchPresentForMacOrLinux(item, architecture, platform) { return item.files.some((file) => file.arch === architecture && file.platform === platform); } exports.isArchPresentForMacOrLinux = isArchPresentForMacOrLinux; -function findAssetForWindows(releases) { - return releases.files.find((item) => utils_1.WINDOWS_ARCHS.includes(item.arch) && - utils_1.WINDOWS_PLATFORMS.includes(item.platform)); +function findAssetForWindows(releases, architecture) { + architecture = replaceX32toX86(architecture); + return releases.files.find((item) => utils_1.WINDOWS_PLATFORMS.includes(item.platform) && item.arch === architecture); } exports.findAssetForWindows = findAssetForWindows; function findAssetForMacOrLinux(releases, architecture, platform) { return releases.files.find((item) => item.arch === architecture && item.platform === platform); } exports.findAssetForMacOrLinux = findAssetForMacOrLinux; +function replaceX32toX86(architecture) { + // convert x32 to x86 because os.arch() returns x32 for 32-bit systems but PyPy releases json has x86 arch value. + if (architecture === 'x32') { + architecture = 'x86'; + } + return architecture; +} /***/ }), diff --git a/src/install-pypy.ts b/src/install-pypy.ts index 4c49e1150..d8594ba6b 100644 --- a/src/install-pypy.ts +++ b/src/install-pypy.ts @@ -8,7 +8,6 @@ import fs from 'fs'; import { IS_WINDOWS, - WINDOWS_ARCHS, WINDOWS_PLATFORMS, IPyPyManifestRelease, createSymlinkInFolder, @@ -157,7 +156,7 @@ export function findRelease( const isArchPresent = item.files && (IS_WINDOWS - ? isArchPresentForWindows(item) + ? isArchPresentForWindows(item, architecture) : isArchPresentForMacOrLinux(item, architecture, process.platform)); return isPythonVersionSatisfied && isPyPyVersionSatisfied && isArchPresent; }); @@ -181,7 +180,7 @@ export function findRelease( const foundRelease = sortedReleases[0]; const foundAsset = IS_WINDOWS - ? findAssetForWindows(foundRelease) + ? findAssetForWindows(foundRelease, architecture) : findAssetForMacOrLinux(foundRelease, architecture, process.platform); return { @@ -205,11 +204,11 @@ export function pypyVersionToSemantic(versionSpec: string) { return versionSpec.replace(prereleaseVersion, '$1-$2.$3'); } -export function isArchPresentForWindows(item: any) { +export function isArchPresentForWindows(item: any, architecture: string) { + architecture = replaceX32toX86(architecture); return item.files.some( (file: any) => - WINDOWS_ARCHS.includes(file.arch) && - WINDOWS_PLATFORMS.includes(file.platform) + WINDOWS_PLATFORMS.includes(file.platform) && file.arch === architecture ); } @@ -223,11 +222,11 @@ export function isArchPresentForMacOrLinux( ); } -export function findAssetForWindows(releases: any) { +export function findAssetForWindows(releases: any, architecture: string) { + architecture = replaceX32toX86(architecture); return releases.files.find( (item: any) => - WINDOWS_ARCHS.includes(item.arch) && - WINDOWS_PLATFORMS.includes(item.platform) + WINDOWS_PLATFORMS.includes(item.platform) && item.arch === architecture ); } @@ -240,3 +239,11 @@ export function findAssetForMacOrLinux( (item: any) => item.arch === architecture && item.platform === platform ); } + +function replaceX32toX86(architecture: string): string { + // convert x32 to x86 because os.arch() returns x32 for 32-bit systems but PyPy releases json has x86 arch value. + if (architecture === 'x32') { + architecture = 'x86'; + } + return architecture; +} From 4818a5a1535387fb9d6e71f7ace82ad3b405804b Mon Sep 17 00:00:00 2001 From: Sergey Dolin Date: Mon, 24 Oct 2022 11:10:18 +0200 Subject: [PATCH 2/7] Handle download HTTP error (#511) --- dist/setup/index.js | 94 ++++++++++++++++++++++++++++++------------- src/install-pypy.ts | 79 +++++++++++++++++++++++------------- src/install-python.ts | 38 ++++++++++++----- 3 files changed, 143 insertions(+), 68 deletions(-) diff --git a/dist/setup/index.js b/dist/setup/index.js index f153c3c24..2ca2fe1b6 100644 --- a/dist/setup/index.js +++ b/dist/setup/index.js @@ -66511,27 +66511,45 @@ function installPyPy(pypyVersion, pythonVersion, architecture, releases) { const { foundAsset, resolvedPythonVersion, resolvedPyPyVersion } = releaseData; let downloadUrl = `${foundAsset.download_url}`; core.info(`Downloading PyPy from "${downloadUrl}" ...`); - const pypyPath = yield tc.downloadTool(downloadUrl); - core.info('Extracting downloaded archive...'); - if (utils_1.IS_WINDOWS) { - downloadDir = yield tc.extractZip(pypyPath); + try { + const pypyPath = yield tc.downloadTool(downloadUrl); + core.info('Extracting downloaded archive...'); + if (utils_1.IS_WINDOWS) { + downloadDir = yield tc.extractZip(pypyPath); + } + else { + downloadDir = yield tc.extractTar(pypyPath, undefined, 'x'); + } + // root folder in archive can have unpredictable name so just take the first folder + // downloadDir is unique folder under TEMP and can't contain any other folders + const archiveName = fs_1.default.readdirSync(downloadDir)[0]; + const toolDir = path.join(downloadDir, archiveName); + let installDir = toolDir; + if (!utils_1.isNightlyKeyword(resolvedPyPyVersion)) { + installDir = yield tc.cacheDir(toolDir, 'PyPy', resolvedPythonVersion, architecture); + } + utils_1.writeExactPyPyVersionFile(installDir, resolvedPyPyVersion); + const binaryPath = getPyPyBinaryPath(installDir); + yield createPyPySymlink(binaryPath, resolvedPythonVersion); + yield installPip(binaryPath); + return { installDir, resolvedPythonVersion, resolvedPyPyVersion }; + } + catch (err) { + if (err instanceof Error) { + // Rate limit? + if (err instanceof tc.HTTPError && + (err.httpStatusCode === 403 || err.httpStatusCode === 429)) { + core.info(`Received HTTP status code ${err.httpStatusCode}. This usually indicates the rate limit has been exceeded`); + } + else { + core.info(err.message); + } + if (err.stack !== undefined) { + core.debug(err.stack); + } + } + throw err; } - else { - downloadDir = yield tc.extractTar(pypyPath, undefined, 'x'); - } - // root folder in archive can have unpredictable name so just take the first folder - // downloadDir is unique folder under TEMP and can't contain any other folders - const archiveName = fs_1.default.readdirSync(downloadDir)[0]; - const toolDir = path.join(downloadDir, archiveName); - let installDir = toolDir; - if (!utils_1.isNightlyKeyword(resolvedPyPyVersion)) { - installDir = yield tc.cacheDir(toolDir, 'PyPy', resolvedPythonVersion, architecture); - } - utils_1.writeExactPyPyVersionFile(installDir, resolvedPyPyVersion); - const binaryPath = getPyPyBinaryPath(installDir); - yield createPyPySymlink(binaryPath, resolvedPythonVersion); - yield installPip(binaryPath); - return { installDir, resolvedPythonVersion, resolvedPyPyVersion }; }); } exports.installPyPy = installPyPy; @@ -66730,17 +66748,35 @@ function installCpythonFromRelease(release) { return __awaiter(this, void 0, void 0, function* () { const downloadUrl = release.files[0].download_url; core.info(`Download from "${downloadUrl}"`); - const pythonPath = yield tc.downloadTool(downloadUrl, undefined, AUTH); - core.info('Extract downloaded archive'); - let pythonExtractedFolder; - if (utils_1.IS_WINDOWS) { - pythonExtractedFolder = yield tc.extractZip(pythonPath); + let pythonPath = ''; + try { + pythonPath = yield tc.downloadTool(downloadUrl, undefined, AUTH); + core.info('Extract downloaded archive'); + let pythonExtractedFolder; + if (utils_1.IS_WINDOWS) { + pythonExtractedFolder = yield tc.extractZip(pythonPath); + } + else { + pythonExtractedFolder = yield tc.extractTar(pythonPath); + } + core.info('Execute installation script'); + yield installPython(pythonExtractedFolder); } - else { - pythonExtractedFolder = yield tc.extractTar(pythonPath); + catch (err) { + if (err instanceof tc.HTTPError) { + // Rate limit? + if (err.httpStatusCode === 403 || err.httpStatusCode === 429) { + core.info(`Received HTTP status code ${err.httpStatusCode}. This usually indicates the rate limit has been exceeded`); + } + else { + core.info(err.message); + } + if (err.stack) { + core.debug(err.stack); + } + } + throw err; } - core.info('Execute installation script'); - yield installPython(pythonExtractedFolder); }); } exports.installCpythonFromRelease = installCpythonFromRelease; diff --git a/src/install-pypy.ts b/src/install-pypy.ts index d8594ba6b..f7df9c521 100644 --- a/src/install-pypy.ts +++ b/src/install-pypy.ts @@ -46,37 +46,58 @@ export async function installPyPy( let downloadUrl = `${foundAsset.download_url}`; core.info(`Downloading PyPy from "${downloadUrl}" ...`); - const pypyPath = await tc.downloadTool(downloadUrl); - core.info('Extracting downloaded archive...'); - if (IS_WINDOWS) { - downloadDir = await tc.extractZip(pypyPath); - } else { - downloadDir = await tc.extractTar(pypyPath, undefined, 'x'); + try { + const pypyPath = await tc.downloadTool(downloadUrl); + + core.info('Extracting downloaded archive...'); + if (IS_WINDOWS) { + downloadDir = await tc.extractZip(pypyPath); + } else { + downloadDir = await tc.extractTar(pypyPath, undefined, 'x'); + } + + // root folder in archive can have unpredictable name so just take the first folder + // downloadDir is unique folder under TEMP and can't contain any other folders + const archiveName = fs.readdirSync(downloadDir)[0]; + + const toolDir = path.join(downloadDir, archiveName); + let installDir = toolDir; + if (!isNightlyKeyword(resolvedPyPyVersion)) { + installDir = await tc.cacheDir( + toolDir, + 'PyPy', + resolvedPythonVersion, + architecture + ); + } + + writeExactPyPyVersionFile(installDir, resolvedPyPyVersion); + + const binaryPath = getPyPyBinaryPath(installDir); + await createPyPySymlink(binaryPath, resolvedPythonVersion); + await installPip(binaryPath); + + return {installDir, resolvedPythonVersion, resolvedPyPyVersion}; + } catch (err) { + if (err instanceof Error) { + // Rate limit? + if ( + err instanceof tc.HTTPError && + (err.httpStatusCode === 403 || err.httpStatusCode === 429) + ) { + core.info( + `Received HTTP status code ${err.httpStatusCode}. This usually indicates the rate limit has been exceeded` + ); + } else { + core.info(err.message); + } + if (err.stack !== undefined) { + core.debug(err.stack); + } + } + throw err; } - - // root folder in archive can have unpredictable name so just take the first folder - // downloadDir is unique folder under TEMP and can't contain any other folders - const archiveName = fs.readdirSync(downloadDir)[0]; - - const toolDir = path.join(downloadDir, archiveName); - let installDir = toolDir; - if (!isNightlyKeyword(resolvedPyPyVersion)) { - installDir = await tc.cacheDir( - toolDir, - 'PyPy', - resolvedPythonVersion, - architecture - ); - } - - writeExactPyPyVersionFile(installDir, resolvedPyPyVersion); - - const binaryPath = getPyPyBinaryPath(installDir); - await createPyPySymlink(binaryPath, resolvedPythonVersion); - await installPip(binaryPath); - - return {installDir, resolvedPythonVersion, resolvedPyPyVersion}; } export async function getAvailablePyPyVersions() { diff --git a/src/install-python.ts b/src/install-python.ts index aa6ab2d4d..2af61291d 100644 --- a/src/install-python.ts +++ b/src/install-python.ts @@ -72,15 +72,33 @@ export async function installCpythonFromRelease(release: tc.IToolRelease) { const downloadUrl = release.files[0].download_url; core.info(`Download from "${downloadUrl}"`); - const pythonPath = await tc.downloadTool(downloadUrl, undefined, AUTH); - core.info('Extract downloaded archive'); - let pythonExtractedFolder; - if (IS_WINDOWS) { - pythonExtractedFolder = await tc.extractZip(pythonPath); - } else { - pythonExtractedFolder = await tc.extractTar(pythonPath); - } + let pythonPath = ''; + try { + pythonPath = await tc.downloadTool(downloadUrl, undefined, AUTH); + core.info('Extract downloaded archive'); + let pythonExtractedFolder; + if (IS_WINDOWS) { + pythonExtractedFolder = await tc.extractZip(pythonPath); + } else { + pythonExtractedFolder = await tc.extractTar(pythonPath); + } - core.info('Execute installation script'); - await installPython(pythonExtractedFolder); + core.info('Execute installation script'); + await installPython(pythonExtractedFolder); + } catch (err) { + if (err instanceof tc.HTTPError) { + // Rate limit? + if (err.httpStatusCode === 403 || err.httpStatusCode === 429) { + core.info( + `Received HTTP status code ${err.httpStatusCode}. This usually indicates the rate limit has been exceeded` + ); + } else { + core.info(err.message); + } + if (err.stack) { + core.debug(err.stack); + } + } + throw err; + } } From af57b6499414c9dd25c305c7c008a5109c5a188f Mon Sep 17 00:00:00 2001 From: Thomas Kastl Date: Mon, 31 Oct 2022 09:50:28 +0100 Subject: [PATCH 3/7] Extend docu regarding rate limit issues. (#510) --- docs/advanced-usage.md | 26 ++++++++++++++++++++------ 1 file changed, 20 insertions(+), 6 deletions(-) diff --git a/docs/advanced-usage.md b/docs/advanced-usage.md index 243be4335..9fc41aeaa 100644 --- a/docs/advanced-usage.md +++ b/docs/advanced-usage.md @@ -471,15 +471,29 @@ One quick way to grant access is to change the user and group of `/Users/runner/ ## Using `setup-python` on GHES -`setup-python` comes pre-installed on the appliance with GHES if Actions is enabled. When dynamically downloading Python distributions, `setup-python` downloads distributions from [`actions/python-versions`](https://github.com/actions/python-versions) on github.com (outside of the appliance). These calls to `actions/python-versions` are made via unauthenticated requests, which are limited to [60 requests per hour per IP](https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting). If more requests are made within the time frame, then you will start to see rate-limit errors during downloading that looks like: `##[error]API rate limit exceeded for...`. +### Avoiding rate limit issues -To get a higher rate limit, you can [generate a personal access token on github.com](https://github.com/settings/tokens/new) and pass it as the `token` input for the action: +`setup-python` comes pre-installed on the appliance with GHES if Actions is enabled. When dynamically downloading Python distributions, `setup-python` downloads distributions from [`actions/python-versions`](https://github.com/actions/python-versions) on github.com (outside of the appliance). These calls to `actions/python-versions` are by default made via unauthenticated requests, which are limited to [60 requests per hour per IP](https://docs.github.com/en/rest/overview/resources-in-the-rest-api#rate-limiting). If more requests are made within the time frame, then you will start to see rate-limit errors during downloading that look like this: + + ##[error]API rate limit exceeded for YOUR_IP. (But here's the good news: Authenticated requests get a higher rate limit. Check out the documentation for more details.) + +To get a higher rate limit, you can [generate a personal access token (PAT) on github.com](https://github.com/settings/tokens/new) and pass it as the `token` input for the action. It is important to understand that this needs to be a token from github.com and _not_ from your GHES instance. If you or your colleagues do not yet have a github.com account, you might need to create one. + +Here are the steps you need to follow to avoid the rate limit: + +1. Create a PAT on any github.com account by using [this link](https://github.com/settings/tokens/new) after logging into github.com (not your Enterprise instance). This PAT does _not_ need any rights, so make sure all the boxes are unchecked. +2. Store this PAT in the repository / organization where you run your workflow, e.g. as `GH_GITHUB_COM_TOKEN`. You can do this by navigating to your repository -> **Settings** -> **Secrets** -> **Actions** -> **New repository secret**. +3. To use this functionality, you need to use any version newer than `v4.3`. Also, change _python-version_ as needed. ```yml -uses: actions/setup-python@v4 -with: - token: ${{ secrets.GH_DOTCOM_TOKEN }} - python-version: 3.11 +- name: Set up Python + uses: actions/setup-python@4 + with: + python-version: 3.8 + token: ${{ secrets.GH_GITHUB_COM_TOKEN }} ``` +Requests should now be authenticated. To verify that you are getting the higher rate limit, you can call GitHub's [rate limit API](https://docs.github.com/en/rest/rate-limit) from within your workflow ([example](https://github.com/actions/setup-python/pull/443#issuecomment-1206776401)). + +### No access to github.com If the runner is not able to access github.com, any Python versions requested during a workflow run must come from the runner's tool cache. See "[Setting up the tool cache on self-hosted runners without internet access](https://docs.github.com/en/enterprise-server@3.2/admin/github-actions/managing-access-to-actions-from-githubcom/setting-up-the-tool-cache-on-self-hosted-runners-without-internet-access)" for more information. From 47c4a7af1d72897a511c975c95a5335bb6329dec Mon Sep 17 00:00:00 2001 From: Matthieu Darbois Date: Mon, 7 Nov 2022 13:10:21 +0100 Subject: [PATCH 4/7] fix(ci): run `.github/workflows/workflow.yml` on ubuntu-20.04 (#535) --- .github/workflows/workflow.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/workflow.yml b/.github/workflows/workflow.yml index 5c8cc77f9..3575845e5 100644 --- a/.github/workflows/workflow.yml +++ b/.github/workflows/workflow.yml @@ -14,7 +14,7 @@ jobs: runs-on: ${{ matrix.operating-system }} strategy: matrix: - operating-system: [ubuntu-latest, windows-latest] + operating-system: [ubuntu-20.04, windows-latest] steps: - name: Checkout uses: actions/checkout@v3 @@ -68,7 +68,7 @@ jobs: python-version: 3.8 - name: Verify 3.8 run: python __tests__/verify-python.py 3.8 - + - name: Run with setup-python 3.7.5 uses: ./ with: From 5cddb278857fec730853802fad5126d9d78895d5 Mon Sep 17 00:00:00 2001 From: "Watal M. Iwasaki" Date: Mon, 21 Nov 2022 21:47:16 +0900 Subject: [PATCH 5/7] Recommend setting python-version (#545) * Recommend setting python-version * Recommend both options to set Python version Co-authored-by: MaksimZhukov <46996400+MaksimZhukov@users.noreply.github.com> Co-authored-by: MaksimZhukov <46996400+MaksimZhukov@users.noreply.github.com> --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c0ff3c2bd..5b21c77bd 100644 --- a/README.md +++ b/README.md @@ -33,7 +33,7 @@ steps: python-version: 'pypy3.9' - run: python my_script.py ``` -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 using `setup-python`. +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. 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/). From b80efd6bc5dcdc82c015d69ecd3e39320d0095e6 Mon Sep 17 00:00:00 2001 From: "James M. Greene" Date: Thu, 24 Nov 2022 05:14:51 -0600 Subject: [PATCH 6/7] Update to latest `actions/publish-action` (#546) To avoid Actions core deprecation messages. https://github.com/actions/publish-action/releases/tag/v0.2.1 --- .github/workflows/release-new-action-version.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/release-new-action-version.yml b/.github/workflows/release-new-action-version.yml index 968c77fb3..b8076d438 100644 --- a/.github/workflows/release-new-action-version.yml +++ b/.github/workflows/release-new-action-version.yml @@ -21,7 +21,7 @@ jobs: runs-on: ubuntu-latest steps: - name: Update the ${{ env.TAG_NAME }} tag - uses: actions/publish-action@v0.2.0 + uses: actions/publish-action@v0.2.1 with: source-tag: ${{ env.TAG_NAME }} slack-webhook: ${{ secrets.SLACK_WEBHOOK }} From 1aafadcfb96443dc8b2c66d464369fad6ead5571 Mon Sep 17 00:00:00 2001 From: Simon Willison Date: Tue, 29 Nov 2022 09:46:57 -0800 Subject: [PATCH 7/7] Caching projects that use setup.py (#549) --- docs/advanced-usage.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/advanced-usage.md b/docs/advanced-usage.md index 9fc41aeaa..643e73dd6 100644 --- a/docs/advanced-usage.md +++ b/docs/advanced-usage.md @@ -281,6 +281,20 @@ steps: - run: pip install -e . -r subdirectory/requirements-dev.txt ``` +**Caching projects that use setup.py:** + +```yaml +steps: +- uses: actions/checkout@v3 +- uses: actions/setup-python@v4 + with: + python-version: '3.11' + cache: 'pip' + cache-dependency-path: setup.py +- run: pip install -e . + # Or pip install -e '.[test]' to install test dependencies +``` + # Outputs and environment variables ## Outputs