actions-python-core

What it is and what it does

actions-python-core is a lightweight Python library for building GitHub Actions. It wraps the core functions needed to interact with the GitHub Actions runtime: reading inputs (including boolean and multiline variants), setting outputs for downstream actions, logging, registering secrets, and exporting environment variables. The package depends on aiofiles, httpx, and typing-extensions, and targets Python 3.9+.

The library is in pre-alpha status and has been dormant since its latest release. It appears designed for developers writing custom GitHub Actions in Python who need a thin abstraction over the Actions API rather than a full framework. Users should verify whether it remains compatible with current GitHub Actions infrastructure and whether more actively maintained alternatives better serve their use case.

Use it for:

• Reading and parsing action inputs in a custom GitHub Actions workflow step.
• Setting outputs that downstream actions or workflow steps can consume.
• Logging messages and handling secrets within a Python-based GitHub Action.
• Building lightweight custom CI/CD automation without a full framework.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides core utilities for GitHub Actions written in Python, including input/output handling, logging, secret registration, and variable export.

No—unless you are maintaining an existing codebase that already uses it. The package is dormant (latest release October 2023, last commit June 2024), has minimal adoption, and lacks current documentation. Verify first whether GitHub's official Actions toolkit or a more actively maintained alternative better serves your use case.

Install

actions-python-core on PyPI

pip install actions-python-core

uv add actions-python-core

poetry add actions-python-core

Installing actions-python-core

Before you install

Low install friction with a pure-Python wheel. Maintenance is dormant—last release was in October 2023 and the repository shows minimal activity (2 stars, last commit June 2024), so expect no active support or updates.

License in practice

MIT license permits commercial and private use with minimal restrictions, making it safe to adopt from a licensing perspective.

Quickstart

pip install actions-python-core

from actions import core

my_input = core.get_input("input_name", required=True)
core.set_output("output_key", "output_value")

Requires Python 3.9 or later.

Verify before relying

• Whether the package is actively maintained or has been superseded by an official GitHub Actions Python toolkit.
• Real-world compatibility with current GitHub Actions runner environments.
• Completeness of the API—the description excerpt ends with 'TBD', suggesting documentation may be incomplete.
• Current adoption and whether the low download volume reflects niche use or declining interest.

Package facts

Evidence: actions_python_core-0.1.3-py3-none-any.whl

Keywords: action, ci, github

Tags

More Python Modules packages