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.2

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.2
File	Size	Uploaded
jcl_parser-2.0.2.tar.gz	183.6 kB	Oct 13, 2026	Details

Built distribution (wheel)

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

Total release size: 399.5 kB

Release files / jcl_parser-2.0.2.tar.gz

Download URL	jcl_parser-2.0.2.tar.gz
Size	183.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`5db3d87a41b5757da8d1f57869f308e1154fab527827f0f2a8e48aa8c8160d3c`
BLAKE2b-256 checksum How to use checksums	`24bc4c879b5f1021abd6c3bce606739585c1c1a2bec02632c8739b99e47e2f40`
Upload date	Oct 13, 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/d0e5bd5be0de6eddb1301f88e5f03a4c40c1990f

Workflow

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

Artifact

Subject: jcl_parser-2.0.2.tar.gz
SHA-256 checksum: 5db3d87a41b5757da8d1f57869f308e1154fab527827f0f2a8e48aa8c8160d3c Verifying attestations

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

Download URL	jcl_parser-2.0.2-py3-none-any.whl
Size	215.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6ecdda9a6442ae3b7984109ee81ae6705737969406aefb2b9d0d5911696fdedc`
BLAKE2b-256 checksum How to use checksums	`a611deb36aec01561ce33181211c20ee250bb1462aab2e31f15fbeb11e972690`
Upload date	Oct 13, 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/d0e5bd5be0de6eddb1301f88e5f03a4c40c1990f

Workflow

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

Artifact

Subject: jcl_parser-2.0.2-py3-none-any.whl
SHA-256 checksum: 6ecdda9a6442ae3b7984109ee81ae6705737969406aefb2b9d0d5911696fdedc Verifying attestations