A lightweight tool to compile project files and directories into a structured Markdown document
Project description
RepoScribe
RepoScribe is a basic, lightweight tool for compiling your codebase and directory structure into a structured Markdown document. It is designed to enrich Large Language Models (LLMs) with project-specific context, but it's also highly effective for straightforward navigation and review of code projects or folders. The python package is self-contained, with no external dependencies.
Installation
To install RepoScribe, simply use pip:
pip install RepoScribe
Usage
In the Terminal
RepoScribe can be used directly from your command line. You can run it in your project's root directory to create a Markdown file of the entire project:
reposcribe
This command will generate a reposcribe.md
file in the current directory. If you want to specify the root directory of your project and the output file location, you can do so as follows:
reposcribe /path/to/project /path/to/output.md
In a Python File
You can also use RepoScribe programmatically in your Python scripts. Here's a simple usage example:
from reposcribe import create_doc_file
# Generate documentation for the project
project_doc = create_doc_file(root_path='/path/to/project', save_path='/path/to/output.md')
# The `project_doc` variable now contains the Markdown content
print(project_doc)
Features
- Compile entire projects into a single Markdown document.
- Include a detailed file and directory structure.
- Simple and intuitive command-line interface.
- Flexible usage - run in your project's root directory with no arguments or specify paths as needed.
Planned Features
- Multiple Output Formats: Allow exporting documentation to formats like HTML, PDF, or a Word document.
- Code Syntax Highlighting: Integrate syntax highlighting in the generated Markdown for better readability of code snippets.
- Documenting Non-Code Files: Include a structured summary of non-code files (like images, text files) in the project.
- GitHub Integration: Generate documentation by specifying a public GitHub repository.
- File Type Filters: Specify a list of file extensions or file names to include or exclude from the documentation.
- Dependency Graphs: Generate visual dependency graphs for the project, showing how different files and modules are interconnected.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for RepoScribe-0.1.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | fca8d31feac7cc92b34d4cb1da8cc1cebaffada8667759833e90928d1d7f3eaf |
|
MD5 | 958acb0a076ca445838514e29ba6fb04 |
|
BLAKE2b-256 | f06186ea5dd3662119c2e9b7a32815cd3cf128368a061a312f2fb0f6701fca8c |