Skip to main content

Toolbox

This repository contains helper functions for:

  • Interacting with a run in prepare_assignment
    • Retrieving input
    • Setting output
  • Finding files based on globs

Interacting with prepare_assignment

To help a prepare_assignment action interact with a run, a couple of helper functions are defined in core.py.

To retrieve input use the get_input function, this has the following parameters:

  • key: str: The key of the input to retrieve, this is the same as the key as defined in the action.yml
  • required: bool= False: if true and the key is not present it will raise an exception
  • trim_whitespace: bool: if true it will automatically trim whitespace from the retrieved value

To set output that can be used by other actions in the run, use the set_output function. This function has the following parameters:

  • name: str: the key that other actions can use to retrieve the value
  • value: Any: the value

Furthermore it defines helper methods for logging:

  • set_failed: log exception/message with level ERROR and exit the process
  • set_error: log exception/message with level ERROR
  • set_warning: log message with level WARNING
  • info: log message with level INFO
  • debug: log message with level DEBUG

Finding files

A common task for actions is to find files based on a glob. To make this repetitive task easier a helper function is defined in file.py. The function get_matching_files returns a list of paths (as strings) that match the files, given the parameters. The following parameters are available:

  • included: Union[str, List[str]]: Glob(s) that should be matched
  • excluded: Union[str, List[str], None]: Glob(s) that should be excluded from being matched. I.e. if a path matches the included glob, it should not be processed if it also matches the excluded glob. Default: None
  • relative_to: : Union[str, None]: Set relative path from where the globs should be matched. If None the current working directory is used. Default: None
  • allow_outside_working_dir: bool: Allow relative_to to be outside the current working directory. Allow the matched glob(s) to be outside the relative_to directory. Default: False
  • recursive: bool: If true the glob should recurse directories. Default: True
  • include_hidden: bool: If true wildcards (e.g. * and **) also match hidden files and directories (starting with a .), for both included and excluded. Default: False

Releases

Releases are automated with semantic-release. Pull requests are squash merged, so the PR title becomes the commit on main and must follow Conventional Commits (checked on every PR):

PR title Release
fix: ..., perf: ... patch (1.2.3 → 1.2.4)
feat: ... minor (1.2.3 → 1.3.0)
! after the type (e.g. feat!: ..., refactor!: ...) or a BREAKING CHANGE: footer major (1.2.3 → 2.0.0)
docs:, chore:, ci:, build:, refactor:, test:, style:, revert: no release

On every merge to main the next version is determined, tagged (vX.Y.Z), a GitHub release is created and the package is published to PyPI. The version is set during the build and is not committed, so the version in pyproject.toml is not the released version.

Metadata

Release files for prepare-toolbox 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for prepare-toolbox 1.0.1
File Size Uploaded Provenance Actions
prepare_toolbox-1.0.1.tar.gz 55.3 kB Without provenance Details for prepare_toolbox-1.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for prepare-toolbox 1.0.1
File Interpreter ABI Platform Actions
prepare_toolbox-1.0.1-py3-none-any.whl Python 3 none any Details for prepare_toolbox-1.0.1-py3-none-any.whl

Total release size: 62.7 kB

Release files / prepare_toolbox-1.0.1.tar.gz

Download URL prepare_toolbox-1.0.1.tar.gz
Size 55.3 kB
Tags Source
SHA-256 checksum
How to use checksums
c11f499018b181ae4bc548669de698ee50dfbd309d9080e9538920c046798959
BLAKE2b-256 checksum
How to use checksums
806785a18c89af943534c23ce825de8e6e17550481f8c90e02db1c3a2d8a865e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / prepare_toolbox-1.0.1-py3-none-any.whl

Download URL prepare_toolbox-1.0.1-py3-none-any.whl
Size 7.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
41e10ac9fa61e0cfe53d5c04b69baf2b0ee8a607dda2c9825c6ce0293055fd57
BLAKE2b-256 checksum
How to use checksums
b435dd4cacca4d58361b66394160f9ca0f4062c2b5e55c0a8aa1dc557d347a63
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for prepare-toolbox 1.0.1

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page