readme-builder 0.1.3

Create contextual README.md files

Readme Builder

This project provides a command-line tool for generating README files automatically independent of programming language. It generates a comprehensive and informative README (requires minimal editing) file based on the project structure and files present.

Features

• Automatic README Generation: Analyzes project files and structure to automatically generate a well-formatted README.md file.
• Project Overview: Provides a concise overview of the project's purpose and functionality.
• Feature Listing: Identifies and lists key features based on the project's directory structure and file names.
• Installation Instructions: Generates installation instructions tailored to the project's dependencies and environment management tools.
• Usage Examples: Provides code examples and command-line instructions for running and using the project.

Installation

Ensure you have python3 and pip on your system.

pip install readme-builder

Usage

Run the CLI:

build-readme <path-to-directory>

This will analyze the project structure and generate a README.md file in the specified directory.

Contact Information

For any inquiries or feedback, please contact:

• Email: akshitadixit[dot]int[at]gmail[dot]com

Privacy concerns

This application collects a list of file names, plus the contents of the LICENSE file, CONTRIBUTING, and extracted contact information from the README.md or configuration files. This does not include the content of other files, just the file names. It then sends this information to a web service hosted on onrender.com, which uses Google's Gemini LLM service to generate the README.md file.

In some situations, this may raise privacy concerns despite not sending file contents. While not a concern in most contexts, company security policies, including automated tools, may be triggered by this activity. Please examine the code to verify exactly what data is being sent and assess whether sending this data off-site could be an issue in your environment.

In most cases, this would not be considered sensitive information, and no other use is made of it in any case.

Doesn't work that well?

If your project is a very vague directory with random file names, not even a human would have context about it, this is still AI. Also this package is written with the purpose of generating a README that requires minimal editing. Take waht is generates, add a couple of fixes and you're good to go.
If however, something super unusual comes up, please raise it to me. Thanks.