---
id: github-action-utils
version: "1.1.0"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# github-action-utils — Collection of python functions that can be used to run GitHub Action Workflow Commands

License: permissive · Maintenance: dormant · Downloads: 817.3K/mo

## What it is and what it does

This package wraps GitHub Actions workflow commands as Python functions, allowing you to emit structured logs, set step outputs, manage state, and organize workflow console output from within a Python script running in an action. It provides functions for debug, notice, warning, and error messages with optional file/line annotations, output parameter setting via GITHUB_OUTPUT, state management via GITHUB_STATE, job summary appending, and log grouping. The package has no external runtime dependencies and works by writing to GitHub's standard environment files or echoing command syntax to stdout.

It is designed specifically for use inside GitHub Actions workflows—either as a standalone Python step or embedded in a workflow's inline Python shell. The functions map directly to GitHub's documented workflow command syntax, so you write Python instead of shell echo statements to control action behavior and logging.

Use it for:

- Emit structured debug, warning, and error messages with file/line annotations from a Python action step.
- Set step outputs and state variables for use in downstream steps or post-action cleanup.
- Append formatted markdown content to the job summary visible in the workflow run UI.
- Group related log lines into collapsible sections to reduce workflow console noise.
- Stop and restart workflow command processing to log raw text without accidental command interpretation.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python functions to invoke GitHub Actions workflow commands (logging, output setting, state management, grouping) from within an action script.

Yes, if you are writing Python code inside a GitHub Actions workflow and want a cleaner API than shell echo commands. The package is stable, has no dependencies, carries a permissive MIT license, and has no known vulnerabilities. The dormant maintenance status (last release 2022-10-17) is not a blocker for a thin wrapper around stable GitHub APIs, but verify that the documented functions still work with your target Python and Actions environment before relying on it in production.

## Install

pip install github-action-utils
uv add github-action-utils
poetry add github-action-utils

## Installing github-action-utils

Before you install: Low install friction with no runtime dependencies. Maintenance is dormant—last release was 2022-10-17 and last commit 2023-10-01—but the package is not archived and has no known vulnerabilities.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install github-action-utils

import github_action_utils as gha_utils

gha_utils.set_output("my_output", "test_value")
gha_utils.error("Error message", title="Error Title", file="example.py", col=1, line=1)

Must run inside a GitHub Actions workflow environment to access GITHUB_OUTPUT, GITHUB_STATE, and other action-specific environment variables.

Verify before relying:

- Whether dormant status (last commit 2023-10-01) affects compatibility with recent GitHub Actions API changes.
- Whether all documented functions work correctly with Python 3.11 and 3.10 given the long maintenance gap.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 817.3K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

github actions python workflow commands, github action logging and output, github actions state management, workflow command wrapper python, github actions debug error notice, github action job summary, github actions grouped logs, github-actions, workflow-automation, ci-cd

[View on SkillFed](https://skillfed.io/packages/github-action-utils) · [View on PyPI](https://pypi.org/project/github-action-utils/)