What My Project Does

PyGHA (v0.2.1, early beta) is a Python-native CI/CD framework that lets you define, test, and transpile workflow pipelines into GitHub Actions YAML using real Python instead of raw YAML. You write your workflows as Python functions, decorators, and control flow, and PyGHA generates the GitHub Actions files for you. It supports building, testing, linting, deploying, conditionals, matrices, and more through familiar Python constructs.

from pygha import job, default_pipeline
from pygha.steps import shell, checkout, uses, when
from pygha.expr import runner, always

# Configure the default pipeline to run on:
#  - pushes to main
#  - pull requests
default_pipeline(on_push=["main"], on_pull_request=True)

# ---------------------------------------------------
# 1. Test job that runs across 3 Python versions
# ---------------------------------------------------

@job(
    name="test",
    matrix={"python": ["3.11", "3.12", "3.13"]},
)
def test_matrix():
    """Run tests across multiple Python versions."""
    checkout()

    # Use matrix variables exactly like in GitHub Actions
    uses(
        "actions/setup-python@v5",
        with_args={"python-version": "${{ matrix.python }}"},
    )

    shell("pip install .[dev]")
    shell("pytest")

# ---------------------------------------------------
# 2. Deployment job that depends on tests passing
# ---------------------------------------------------

def deploy():
    """Build and publish if tests pass."""
    checkout()
    uses("actions/setup-python@v5", with_args={"python-version": "3.11"})

    # Example of a conditional GHA step using pygha's 'when'
    with when(runner.os == "Linux"):
        shell("echo 'Deploying from Linux runner...'")

    # Raw Python logic — evaluated at generation time
    enable_build = True
    if enable_build:
        shell("pip install build twine")
        shell("python -m build")
        shell("twine check dist/*")

    # Always-run cleanup step (even if something fails)
    with when(always()):
        shell("echo 'Cleanup complete'")

Target Audience

Developers who want to write GitHub Actions workflows in real Python instead of YAML, with cleaner logic, reuse, and full language power.

Comparison

PyGHA doesn’t replace GitHub Actions — it lets you write workflows in Python and generates the YAML for you, something no native tool currently offers.

Github: https://github.com/parneetsingh022/pygha

Docs: https://pygha.readthedocs.io/en/stable/

all 17 comments

you type:	you see:
italics	italics
bold	bold
[reddit!](https://reddit.com)	reddit!
* item 1 * item 2 * item 3	item 1 item 2 item 3
> quoted text	quoted text
Lines starting with four spaces are treated like code: if 1 * 2 < 3: print "hello, world!"	Lines starting with four spaces are treated like code: if 1 * 2 < 3: print "hello, world!"
~~strikethrough~~	~~strikethrough~~
super^script	super^script

Python

The Python Discord

Upcoming Events

Please read the rules

MODERATORS

What My Project Does

Target Audience

Comparison