actions-includes
Allows including an action inside another action (by preprocessing the YAML file).
Instead of using uses or run in your action step, use the keyword includes.
Once you are using the includes argument, the workflows can be expanded using this tool as follows:
# python -m actions_include <input-workflow-with-includes> <output-workflow-flattened>
python -m actions_includes ./.github/workflows-src/workflow-a.yml ./.github/workflows/workflow-a.yml
Usage with docker
docker container run --rm -it -v $(pwd):/github/workspace --entrypoint="" ghcr.io/mithro/actions-includes/image:main python -m actions_includes ./.github/workflows-src/workflow-a.yml ./.github/workflows/workflow-a.yml
includes: step
steps:
- name: Other step
run: |
command
- includes: {action-name}
with:
{inputs}
- name: Other step
run: |
command
The {action-name} follows the same syntax as the standard GitHub action
uses
and the action referenced should look exactly like a
GitHub "composite action"
except runs.using should be includes.
For example;
{owner}/{repo}@{ref}- Public action ingithub.com/{owner}/{repo}{owner}/{repo}/{path}@{ref}- Public action under{path}ingithub.com/{owner}/{repo}../{path}- Local action under local{path}, IE./.github/actions/{action-name}.
As it only makes sense to reference composite actions, the docker:// form isn't supported.
As you frequently want to include local actions, actions-includes extends the
{action-name} syntax to also support:
/{name}- Local action under./.github/includes/actions/{name}.
This is how composite actions should have worked.
includes-script:
You can include a script (e.g., a Python or shell script) in your workflow.yml file using the includes-script step.
Example script file: script.py
print('Hello world')
To include the script, reference it in an includes-script action in your workflow.yml, like so:
steps: - name: Other step run: | command - name: Hello includes-script: script.py - name: Other step run: | command
When the workflow.yml is processed by running
python -m actions_includes.py workflow.in.yml workflow.out.yml,
the resultant workflow.out.yml looks like this:
steps: - name: Other step run: | command - name: Hello shell: python run: | print('Hello world') - name: Other step run: | command
The shell parameter is deduced from the file extension,
but it is possible to use a custom shell by setting the
shell parameter manually.
Using a pre-commit hook
When you use actions-includes, it may be useful to add a pre-commit hook (see https://git-scm.com/docs/githooks) to your project so that your workflow files are always pre-processed before they reach GitHub.
With a git hooks package
There are multiple packages (notably pre-commit;
see https://pre-commit.com/) that support adding pre-commit hooks.
In the case of using the pre-commit package, you can add an entry
such as the following to your pre-commit-config.yaml file:
- repo: local hooks: - id: preprocess-workflows name: Preprocess workflow.yml entry: python -m actions_includes.py workflow.in.yml workflow.out.yml language: system always-run: true
Without a git hooks package
Alternatively, to add a pre-commit hook without installing another
package, you can simply create or modify .git/hooks/pre-commit
(relative to your project root). A sample file typically
lives at .git/hooks/pre-commit.sample.
The pre-commit hook should run the commands that are necessary to
pre-process your workflows. So, your .git/hooks/pre-commit file
might look something like this:
#!/bin/bash python -m actions_includes.py workflow.in.yml workflow.out.yml || { echo "Failed to preprocess workflow file.""" }
To track this script in source code management, you'll have to
put it in a non-ignored file in your project that is then copied to
.git/hooks/pre-commit as part of your project setup. See
https://github.com/ModularHistory/modularhistory for an example
of a project that does this with a setup script (setup.sh).
Release files for actions-includes 0.0.post138
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| actions-includes-0.0.post138.tar.gz | 39.1 kB | Without provenance | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| actions_includes-0.0.post138-py3.9.egg | Legacy Egg format | - | - | Details |
| actions_includes-0.0.post138-py3.8.egg | Legacy Egg format | - | - | Details |
| actions_includes-0.0.post138-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 185.7 kB
Release files / actions-includes-0.0.post138.tar.gz
| Download URL | actions-includes-0.0.post138.tar.gz |
|---|---|
| Size | 39.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1de2e5a0eb1c778fa8609780be35aeb7e3709834d427dd1e2e656e5a13d2da68
|
|
BLAKE2b-256 checksum How to use checksums |
bcdd48ba68820ba234c5b17dd182634c52d40299fda870ebc37c647ff0a8c40f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.8.16
|
Release files / actions_includes-0.0.post138-py3.9.egg
| Download URL | actions_includes-0.0.post138-py3.9.egg |
|---|---|
| Size | 57.7 kB |
| Tags | Egg |
|
SHA-256 checksum How to use checksums |
bf7d7709113f36049332338613f95d15e841c428391e1ff56bd67b96187829d1
|
|
BLAKE2b-256 checksum How to use checksums |
78b13de62292a07875ce33e6f60fb90cfe92f91eb48c14f9b875b0d98ba3ad8c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.9.16
|
Release files / actions_includes-0.0.post138-py3.8.egg
| Download URL | actions_includes-0.0.post138-py3.8.egg |
|---|---|
| Size | 57.7 kB |
| Tags | Egg |
|
SHA-256 checksum How to use checksums |
39b790c7f172d038157f1e172e98f5d0fc820f6dcf0b70d4cf629e0c675af0a3
|
|
BLAKE2b-256 checksum How to use checksums |
117d3064c5bded15244f6e5d8f0877b5b0c55dc8dc040767ac35039b76f986d7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.8.16
|
Release files / actions_includes-0.0.post138-py3-none-any.whl
| Download URL | actions_includes-0.0.post138-py3-none-any.whl |
|---|---|
| Size | 31.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f8fc4a5f4a19d3d20bfa6b1b6b64a5570262c76faa9eec57ea98408a3558e921
|
|
BLAKE2b-256 checksum How to use checksums |
c09805efa853b59317532ba4aae213a8ba1268db1ba939c54f5bd327eb2ccd07
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.8.16
|
Security for actions-includes 0.0.post138
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
