moppy-cli 1.0.0

CLI tool to clean, format and reorganize Python source files.

Moppy 🧹

A CLI tool that cleans and restructures Python source files.

What it does

Step	Action
1	Remove # inline comments (--remove-comments)
2	Remove docstrings (--remove-docstrings)
3	Reorder code structure (--reorganize)
4	Auto-format with black, isort, autoflake

Code order after --reorganize

imports          →  import / from … import
variables        →  module-level constants and assignments
schemas/models   →  dataclasses, Pydantic BaseModel, TypedDict …
classes          →  regular class definitions
functions        →  def / async def
other            →  if __name__ == "__main__", bare expressions …

---

Install

pip install .

Or in editable / development mode:

pip install -e .

---

Usage

# Clean a single file (format only)
moppy myfile.py

# Remove comments
moppy myfile.py --remove-comments

# Remove comments + docstrings + reorder structure
moppy myfile.py --remove-comments --remove-docstrings --reorganize

# Clean an entire directory recursively
moppy ./src --reorganize

# Only current directory, no sub-folders
moppy ./src --no-recursive

# Preview changes without writing any files
moppy ./src --dry-run --reorganize

---

Options

Flag	Description
--remove-comments	Strip all # comments
--remove-docstrings	Strip all docstrings
--reorganize	Reorder top-level statements
--dry-run	Show results without modifying files
--recursive / --no-recursive	Recurse into sub-directories (default: on)

---

Dependencies

• click — CLI framework
• black — code formatter
• isort — import sorter
• autoflake — unused import/variable remover