masoumi 0.2.1

Python developer toolkit — performance analyzer and more

masoumi

Python developer toolkit — performance analyzer and more.

▶️ Watch demo on GitHub

Install

pip install masoumi

Usage

import masoumi

code = open("my_script.py").read()

# Analyze full file
issues = masoumi.analyze(code)

# Analyze specific line range
issues = masoumi.analyze(code, start=10, end=50)

# Analyze a file directly
issues = masoumi.analyze_file("my_script.py", start=1, end=100)

# Use in CI/CD — no print, just data
issues = masoumi.analyze(code, print_report=False)
high = [i for i in issues if i.severity == "HIGH"]
if high:
    raise SystemExit(f"{len(high)} high severity issue(s) found.")

# Get results as plain dicts (for JSON, logging, etc.)
data = masoumi.issues_as_dicts(issues)

# Enable runtime profiling (executes your code — use on trusted scripts only)
issues = masoumi.analyze(code, runtime=True)

What it detects

Severity	Issue
🔴 HIGH	String concatenation += inside loops
🔴 HIGH	Mutable default argument (list, dict, set)
🟡 MEDIUM	Nested loops (O(n²) complexity warning)
🟡 MEDIUM	list.append() inside loop (use comprehension)
🟡 MEDIUM	in lookup on list/tuple instead of set
🟡 MEDIUM	Bare except: clause
🟡 MEDIUM	Recursive function without clear base case
🟡 MEDIUM	global variable usage
🔵 LOW	Unnecessary pass statements
🔵 LOW	Imports inside functions
🔵 LOW	Functions with too many parameters (>7)
🟣 PROFILE	Slow functions — runtime profiling (runtime=True)

Return value

analyze() and analyze_file() return a list[Issue].
Each Issue has:

issue.line      # int — line number
issue.severity  # str — "HIGH" / "MEDIUM" / "LOW" / "PROFILE"
issue.message   # str — what was detected
issue.tip       # str — how to fix it
issue.code      # str — the offending line of code
issue.to_dict() # dict — all of the above as a plain dict

CI/CD example

python -c "
import masoumi, sys
issues = masoumi.analyze_file('my_script.py', print_report=True)
if any(i.severity == 'HIGH' for i in issues):
    sys.exit(1)
"

License

MIT