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: index.md

License

Proprietary EULA — see LICENSE.

Metadata

Release files for jcl-parser 1.3.0

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 1.3.0
File	Size	Uploaded
jcl_parser-1.3.0.tar.gz	115.2 kB	Sep 1, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for jcl-parser 1.3.0
File	Interpreter	ABI	Platform	Reset
jcl_parser-1.3.0-py3-none-any.whl 143.1 kB Sep 1, 2026	Python 3	none	any	Details

Total release size: 258.3 kB

Release files / jcl_parser-1.3.0.tar.gz

Download URL	jcl_parser-1.3.0.tar.gz
Size	115.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`55387678202fd2eefad1d01c71c61491c89d027cddcee9493ca09c843c15581e`
BLAKE2b-256 checksum How to use checksums	`b614cd58dbbb4ef42b5306327a5487b701f262ee872d534673adbc7c188713c5`
Upload date	Sep 1, 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/6c0635b4ceb292eb49054b40119fdb5a592d9251

Workflow

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

Artifact

Subject: jcl_parser-1.3.0.tar.gz
SHA-256 checksum: 55387678202fd2eefad1d01c71c61491c89d027cddcee9493ca09c843c15581e Verifying attestations

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

Download URL	jcl_parser-1.3.0-py3-none-any.whl
Size	143.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d340a5b990cd30722bb777e1b089c4f83a0ea76a6d07acce2533c4eb9fc45d88`
BLAKE2b-256 checksum How to use checksums	`b0b3ccbcb8e4682471218e33b2bb62674c2170c29dd78309e1c4999308d83d7a`
Upload date	Sep 1, 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/6c0635b4ceb292eb49054b40119fdb5a592d9251

Workflow

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

Artifact

Subject: jcl_parser-1.3.0-py3-none-any.whl
SHA-256 checksum: d340a5b990cd30722bb777e1b089c4f83a0ea76a6d07acce2533c4eb9fc45d88 Verifying attestations