actionlint-py

library1.7.12.24pypypiunverified

Python wrapper for running actionlint – a static checker for GitHub Actions workflow files. Provides a simple Python API and CLI to validate .github/workflows/*.yml files. Current version 1.7.12.24 (wraps actionlint 1.7.12). Active development with monthly releases.

devops

pip install actionlint-py

github ↗homepage ↗

INSTALL

IMPORT

SIG · ACTIONLINT-PY

actionlint-py

devopspythonv1.7.12.24

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Actionlint

✓ from actionlint_py import Actionlint

✗ from actionlint_py import Actionlint

Run actionlint on a directory of workflow files and print errors.

import os from actionlint_py import Actionlint actionlint = Actionlint() results = actionlint.check(".github/workflows") for result in results: print(result.message)

Debug

Known issues

deprecatedThe `check_string` method (e.g., actionlint.check_string("name: ci")) was deprecated in v1.7.x and may be removed. Use `Actionlint.check()` with a file path or the CLI directly.

fix

Replace `actionlint.check_string(content)` with writing content to a temp file and calling `actionlint.check(file_path)`. Or use the CLI: `actionlint -stdin`.

affects: >=1.7.0

gotchaactionlint binary bundled with the package may not work on all architectures (e.g., ARM macOS if not downloaded separately). The package tries to download the matching binary on first use, but permissions or network issues can cause silent failures.

fix

Ensure network access and write permissions to the package's binary cache directory. Alternatively, set environment variable ACTIONLINT_PATH to a pre-installed actionlint binary.

affects: all

breakingVersions before 1.6.0 used a different API: `actionlint_py.run()` and `actionlint_py.run_string()`. These are removed in 1.7+.

fix

Upgrade to >=1.6.0 and use `Actionlint` class API.

affects: <1.6.0

Upgrade

Version history

1.7.12.24latest on PyPI · released Mar 31, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

43 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/Mateusz-Grzelinski/actionlint-py ↗

homepagehttps://github.com/Mateusz-Grzelinski/actionlint-py ↗