gittxt 1.1.0

CLI tool for extracting text from Git repositories

📝 Gittxt: Extract Text from Git Repositories

Gittxt is a lightweight CLI tool that scans Git repositories (local or remote) and extracts text content into a consolidated file (.txt, .json).
It is designed for code summarization, AI preprocessing, offline reading, and documentation generation.

🚀 Features

• ✅ Scan Local or Remote Repositories (git clone support)
• ✅ Include & Exclude File Patterns (--include .py, --exclude node_modules)
• ✅ Multi-threaded Scanning (Optimized for large repositories)
• ✅ Supports JSON & TXT Output Formats (--output-format json)
• ✅ Incremental Caching for Faster Scans (Skips unchanged files)
• ✅ Force Full Rescan When Needed (--force-rescan)
• ✅ Improved Logging & Error Handling (More detailed messages for debugging)
• ✅ Better CLI Experience (Handles invalid inputs more effectively)

---

📌 Installation (From PyPI)

Now available on PyPI! 🎉 Install it with:

pip install gittxt

✅ Verify Installation

gittxt --help

Expected Output:

Usage: gittxt [OPTIONS] SOURCE
Options:
  --include TEXT
  --exclude TEXT
  --size-limit INTEGER
  --branch TEXT
  --output-dir TEXT
  --output-format [txt|json]
  --max-lines INTEGER
  --force-rescan
  --help  Show this message and exit.

---

📌 Usage Examples

1️⃣ Scan a Local Folder

gittxt .

📌 Result: Outputs extracted text from the repo.

---

2️⃣ Scan a Remote GitHub Repository

gittxt https://github.com/torvalds/linux

📌 This will:

• Clone the Linux Kernel repo to a temporary directory.
• Extract all readable text.
• Save it in gittxt_output.txt.

---

3️⃣ Customize Output (JSON & TXT)

✅ Save as JSON (Structured Output)

gittxt . --output-format json --output repo_dump.json

✅ Save as TXT (Default)

gittxt . --output-format txt --output repo_dump.txt

---

📌 🚀 New in v1.1.0

• 🐛 Bug Fixes & Improvements

  • Fixed --format argument (Now use --output-format).
  • Better logging & error messages (Now logs issues more clearly).
  • More resilient CLI (Handles invalid paths properly).

• 🛠 Feature Enhancements

  • CLI now supports --force-rescan correctly.
  • Improved caching system (Scans only modified files).
  • More detailed scan reports.

• ✅ Full Test Coverage

  • 18/18 tests passing 🟢
  • New CLI tests added (pytest tests/).

---

📌 Development & Contribution

Want to contribute? Follow these steps:

1️⃣ Run Tests

pytest tests/

2️⃣ Formatting & Linting

black src/

3️⃣ Open a Pull Request

1. Fork the repo
2. Create a new branch (feature/my-change)
3. Push changes
4. Submit a PR! 🚀

---

📌 License

This project is licensed under the MIT License.

---

🚀 Next Steps

• [ ] Add support for Markdown (.md) output.
• [ ] Implement a Web UI for visualization.
• [ ] Improve error handling for edge cases.

---

📌 Made by Sandeep Paidipati