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

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.1
File	Size	Uploaded
jcl_parser-2.0.1.tar.gz	181.3 kB	Oct 13, 2026	Details

Built distribution (wheel)

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

Total release size: 394.7 kB

Release files / jcl_parser-2.0.1.tar.gz

Download URL	jcl_parser-2.0.1.tar.gz
Size	181.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`5ad98b3ae45a82438a34ac2462c47c0711a31d32da9eb79983500347db0ac983`
BLAKE2b-256 checksum How to use checksums	`1d3c2ccf582a3c7e02096a665033caedbbb0d94f4e307ca09d475071b0c14eb7`
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/aff489b0d5a968500ecb5e15631e72c86239e5e8

Workflow

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

Artifact

Subject: jcl_parser-2.0.1.tar.gz
SHA-256 checksum: 5ad98b3ae45a82438a34ac2462c47c0711a31d32da9eb79983500347db0ac983 Verifying attestations

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

Download URL	jcl_parser-2.0.1-py3-none-any.whl
Size	213.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`eb5ba796bd936fceeb70e901b1adc2739860614c31ad49505a9bf5b72a44c3d7`
BLAKE2b-256 checksum How to use checksums	`c6ca6b6db50adda7e6fa01a450802285062506796ccad34f071b3d6ca590a53f`
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/aff489b0d5a968500ecb5e15631e72c86239e5e8

Workflow

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

Artifact

Subject: jcl_parser-2.0.1-py3-none-any.whl
SHA-256 checksum: eb5ba796bd936fceeb70e901b1adc2739860614c31ad49505a9bf5b72a44c3d7 Verifying attestations