pystreamliner

Automatically clean up messy Python files — without breaking anything.

pystreamliner uses Python's AST (abstract syntax tree) to safely detect and fix common code issues. It operates on two tiers: things it can fix automatically with zero risk, and things it flags for you to review manually.

What it does

Auto-fixes (Tier 1 — applied immediately):

Removes unused imports, or trims partially unused from x import y statements
Removes consecutive duplicate lines
Caps excessive blank lines

Warnings (Tier 2 — reported, never auto-changed):

Unused variables
Unused top-level functions
Vague variable names (x, tmp, foo, bar, etc.)

pystreamliner never touches code it isn't certain about. If there's any doubt, it warns you instead.

Install

pip install pystreamliner

No dependencies. Runs on Python 3.10+.

Usage

python streamliner.py your_file.py

This will:

Analyze your_file.py
Write the cleaned version in-place
Print a full report of what was changed and what needs manual review
Show a diff of every modification

Preview changes without modifying anything:

python streamliner.py --dry-run your_file.py

Example output

══════════════════════════════════════════
  PyStreamliner Report
══════════════════════════════════════════
  File:                        main.py
  Lines analyzed:                   312

  Auto-fixes applied:
    Unused imports removed:           3
    Duplicate lines removed:          1
    Blank lines reduced:              2

  Warnings (manual review needed):
    Unused variables detected:        2
    Unused functions detected:        1
    Vague variable names:             1
──────────────────────────────────────────

  Unused imports removed:
    • line 4:  import os
    • line 5:  import sys
    • line 7:  from pathlib import Path, PurePath  (partially cleaned: kept 'Path')

  Unused variables:
    ⚠ line 42:  result
    ⚠ line 87:  temp_val

  Vague variable names:
    ⚠ line 23:  tmp
══════════════════════════════════════════

Why not just use Black / isort / autoflake?

Those are great tools and pystreamliner doesn't replace them. The difference:

Black formats style. pystreamliner removes dead code.
autoflake removes unused imports but doesn't warn about unused variables, vague names, or dead functions.
pystreamliner combines lightweight static analysis with conservative auto-fixing and a human-readable report — in a single file with zero dependencies.

Contributing

See CONTRIBUTING.md.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pystreamliner-1.14.0.tar.gz (6.0 kB view details)

Uploaded Aug 4, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pystreamliner-1.14.0-py3-none-any.whl (6.4 kB view details)

Uploaded Aug 4, 2026 Python 3

File details

Details for the file pystreamliner-1.14.0.tar.gz.

File metadata

Download URL: pystreamliner-1.14.0.tar.gz
Upload date: Aug 4, 2026
Size: 6.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pystreamliner-1.14.0.tar.gz
Algorithm	Hash digest
SHA256	`5959c9e3e919103393935252751ac7df36710cc655c2fe7ee11949670629085a`
MD5	`1853e77e46e5ed7aa711f018df80e5fa`
BLAKE2b-256	`9a02160f657e8eeede78847ca9997c87f2ba4fa6e62aeb765d3e3c92fab57b16`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pystreamliner-1.14.0.tar.gz:

Publisher: main.yml on Supe232323/pystreamliner

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pystreamliner-1.14.0.tar.gz
- Subject digest: 5959c9e3e919103393935252751ac7df36710cc655c2fe7ee11949670629085a
- Sigstore transparency entry: 2341277123
- Sigstore integration time: Aug 4, 2026
Source repository:
- Permalink: Supe232323/pystreamliner@764df666d88d99e9564297618ec784a88f2d2b9f
- Branch / Tag: refs/heads/main
- Owner: https://github.com/Supe232323
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: main.yml@764df666d88d99e9564297618ec784a88f2d2b9f
- Trigger Event: push