jcl-parser

Python library for parsing IBM z/OS JCL (Job Control Language) into structured Job, Step, and DD objects. Supports PROC expansion, validation, lint rules, SQL detection, and dataset lifecycle analysis.

Install

pip install -e ".[dev]"

Requires Python 3.10+. No runtime dependencies.

Quick Start

import jclparser

job = jclparser.parse_jcl(source)
print(job.name)
print(job.steps[0].program)

CLI:

jcl-parser FILE steps          # list all steps
jcl-parser FILE --validate     # validate JCL
jcl-parser FILE lint           # run lint rules
jcl-parser FILE --json         # full parse result as JSON

Commands

# Tests
pytest
pytest -m unit

# Lint / format / type-check
ruff check . && ruff format .
mypy jclparser/

# Vendor sync (after changes to jclparser/) — rm first: plain `cp -r` nests
# into dest/jclparser/jclparser/ and leaves stale files when dest exists
rm -rf ../backend/_vendor/jcl-parser/jclparser && cp -r jclparser/ ../backend/_vendor/jcl-parser/jclparser

Documentation

Full reference: .okf/index.md

License

Metadata

Release files for jcl-parser 2.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jcl-parser 2.0.3
File	Size	Uploaded
jcl_parser-2.0.3.tar.gz	184.8 kB	Oct 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for jcl-parser 2.0.3
File	Interpreter	ABI	Platform	Reset
jcl_parser-2.0.3-py3-none-any.whl 217.1 kB Oct 14, 2026	Python 3	none	any	Details

Total release size: 401.8 kB

Release files / jcl_parser-2.0.3.tar.gz

Download URL	jcl_parser-2.0.3.tar.gz
Size	184.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`0e109ae353c349ec4b9b9c910bc47c3593adb44f2105a89a10f09e083b082f19`
BLAKE2b-256 checksum How to use checksums	`9e18a6ab12a80c33d8afac62b617913d925842cdb3642aa269e53a460fb89ff6`
Upload date	Oct 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Landparty/jcl-parser
Publishing commit: github.com/Landparty/jcl-parser/tree/1fcb9a96f22adb8acd3735eea2be142ef982507c

Workflow

Publishing configuration: github.com/Landparty/jcl-parser/blob/1fcb9a96f22adb8acd3735eea2be142ef982507c/.github/workflows/release-please.yml
Publishing logs: github.com/Landparty/jcl-parser/actions/runs/38498334592/attempts/1

Artifact

Subject: jcl_parser-2.0.3.tar.gz
SHA-256 checksum: 0e109ae353c349ec4b9b9c910bc47c3593adb44f2105a89a10f09e083b082f19 Verifying attestations

Release files / jcl_parser-2.0.3-py3-none-any.whl

Download URL	jcl_parser-2.0.3-py3-none-any.whl
Size	217.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9f1b8e4666932b6b110d1e2a5e534bc3bbb30f4fb66c2bb25d43f9218b646847`
BLAKE2b-256 checksum How to use checksums	`8866a99a7f1296e113513dac3561b68e79964b4d809a934184fca50d1f82d177`
Upload date	Oct 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Landparty/jcl-parser
Publishing commit: github.com/Landparty/jcl-parser/tree/1fcb9a96f22adb8acd3735eea2be142ef982507c

Workflow

Publishing configuration: github.com/Landparty/jcl-parser/blob/1fcb9a96f22adb8acd3735eea2be142ef982507c/.github/workflows/release-please.yml
Publishing logs: github.com/Landparty/jcl-parser/actions/runs/38498334592/attempts/1

Artifact

Subject: jcl_parser-2.0.3-py3-none-any.whl
SHA-256 checksum: 9f1b8e4666932b6b110d1e2a5e534bc3bbb30f4fb66c2bb25d43f9218b646847 Verifying attestations