gh-actions-tool-kit 0.1.0

Tiny actions/core-style helpers for Python GitHub Actions

gh-actions-tool-kit

A lightweight, typed, and fully documented Python equivalent of @actions/core for GitHub Actions.

---

🚀 Quick Start

Installation

pip install gh-actions-tool-kit

Usage

# ================================
# greeting.py
# ================================

from actions_core import get_input, set_output, notice, group

def main() -> None:
    name = get_input("name", required=True)
    with group("Greeting"):
        message = f"Hello, {name}!"
        notice(message, title="Python Action")
        set_output("greeting", message)

if __name__ == "__main__":
    main()

Example Workflow

name: demo
on: [push]
jobs:
  run:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.11"
      - name: Run Python Action
        env:
          name: <your name>
        run: python greeting.py

🧩 Features

Feature	Equivalent in JS @actions/core	Status
get_input()	✅	✅
get_boolean_input()	✅	✅
set_output()	✅	✅
export_variable()	✅	✅
add_path()	✅	✅
save_state() / get_state()	✅	✅
set_secret()	✅	✅
append_summary()	✅	✅
notice(), warning(), error()	✅	✅
debug()	✅	✅
group() / start_group() / end_group()	✅	✅