rtk-ai/rtk

Add python3 / python rewrite support

Open

#928 opened on Mar 30, 2026

View on GitHub
 (5 comments) (3 reactions) (0 assignees)Rust (48,085 stars) (2,914 forks)batch import
effort-mediumenhancementgood first issue

Description

Problem

rtk discover shows ~691 python3 heredoc commands and ~289 python3 script invocations not being rewritten. rtk rewrite has no rule for python3 or python.

Patterns to support

Pattern Example Count (30d)
python3 << 'PYEOF' Inline heredoc scripts ~691
python3 script.py Script execution ~289
python -m <module> Module execution (unittest, py_compile) ~83

Reproduction

$ rtk rewrite "python3 << 'PYEOF'"
# exit 1, no output — no rewrite rule

$ rtk rewrite "python3 scripts/my_script.py"
# exit 1, no output

$ rtk rewrite "python -m unittest discover -s ."
# exit 1, no output

Environment

  • rtk 0.30.1
  • macOS (Darwin 23.5.0)

Impact

Python heredoc scripts often produce large DataFrames/dicts as output — high token savings potential. Combined ~1,063 commands over 30 days.

Contributor guide

Tech stack
rustpython
Domain
clitooling
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Rust programmingCLI developmentRegex/pattern matching
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
75
Research direction
Investigate the existing rewrite rule implementation in the Rust source code, likely in a module like 'rewrite' or 'rules'. Look at how similar commands (e.g., 'python2' if exists) are handled. Add new rules for patterns: heredoc with python3, script execution with python3, and module execution with python. Ensure to handle command parsing and token rewriting consistent with existing patterns.
Add python3 / python rewrite support · rtk-ai/rtk#928 | Good First Issue