0xMax42 maxp
0 Followers · 0 Following
Overview Repositories
19
 Projects Packages Code Public Activity Starred Repositories

clipcode (0.3.0)

Published 2025-06-20 15:57:45 +02:00 by maxp

Installation

pip install --index-url  --extra-index-url https://pypi.org/ clipcode

About this package

Kompaktes CLI-Tool zur Extraktion von Quellcodedateien in Markdown-kompatibler Struktur für GPT-Prompts. Exportiert rekursiv Codeblöcke ins Clipboard – ideal für ChatGPT-Analysen.

📋 clipcode

clipcode ist ein minimalistisches, aber leistungsfähiges CLI-Tool zur Extraktion von Quellcodedateien in ein Markdown-kompatibles Format – ideal zur Verwendung in Prompts für ChatGPT & Co. Es exportiert rekursiv Dateien mit bestimmten Endungen und kopiert sie als sauber strukturierte Markdown-Datei direkt in die Zwischenablage.

🚀 Features

  • 🔎 Rekursive Suche nach Quelldateien anhand beliebiger Endungen
  • 📃 Ausgabe als Markdown mit Syntax-Highlighting (z. B. python, bash)
  • 🔹 Kopiert die formatierte Ausgabe direkt ins Clipboard (Wayland via wl-copy)
  • ✨ Ideal zur Prompt-Erzeugung für LLMs wie ChatGPT / GPT-4o
  • 🚀 Extrem schnell, keine Abhängigkeiten außerhalb der Standardbibliothek

⚙️ Installation

📦 Installation (empfohlen)

poetry install
poetry run clipcode ./src py ts sh

oder global installieren (dev)

poetry build
pip install dist/clipcode-*.whl
clipcode ./src py ts sh

🔀 Verwendung

clipcode <pfad> <endung> [<endung> ...]

Beispiel

clipcode ./src py ts sh toml

Dies erzeugt eine Markdown-Ausgabe aller .py, .ts, .sh und .toml Dateien unterhalb von ./src, formatiert mit Syntax-Hervorhebung, und kopiert sie ins Clipboard.

Ergebnis (im Clipboard):

## Projektdateien

### ./src/main.py
```python
# ... dein Code hier ...
```

📁 Projektstruktur

clipcode/
├── cli.py           # Argument-Parsing, Einstiegspunkt
├── exporter.py      # Clipboard-Export und Markdown-Formatierung
├── file_utils.py    # Dateisuche und Inhaltseinlesung
├── syntax.py        # Zuordnung von Dateiendungen zu Markdown-Sprachen
├── __main__.py      # Poetry CLI Entry Point
└── __init__.py

💡 Hinweise

  • Clipboard-Funktion basiert aktuell auf wl-copy (Wayland)
  • Weitere Clipboard-Backends sind leicht integrierbar
  • .clipcodeignore ist geplant (analog zu .gitignore)

✍️ Lizenz

MIT License — siehe LICENSE

📊 Autor

Max P. • 0xMax42.io

Requirements

Requires Python: >=3.11
Details
PyPI
2025-06-20 15:57:45 +02:00
5
Max P.
9.1 KiB
Assets (2)
clipcode-0.3.0-py3-none-any.whl 5.5 KiB
clipcode-0.3.0.tar.gz 3.6 KiB
Versions (7) View all
0.5.0.dev202507211311 2025-07-21
0.5.0 2025-07-21
0.4.0 2025-07-04
0.3.0 2025-06-20
0.2.0 2025-06-14